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Introduction 


This book has been written as an introduction to writing Machine 
Code programs and routines using Assembler language on the MSX range 
ol home computers. 

Not so many years ago machine code was the programmers first 
language, but with the popularity of the home computer Basic has 
become the common language which most micro users cut their teeth on 
and machine code remains a somewhat grey area which most of us see 
In program listings as a series of numbers within DATA statements 
POKEd into high memory locations and then called by the USR command, 
and are left without a clue as to what is happening. 

Machine code programs, operate far quicker than those written.in 
Basic and that is one reason for a Basic program to contain a 
machine code routine in order to achieve greater speed, or it could 
be used to modify Basic to do tasks it cannot normally do. 

This book hopefully will make machine code clearer and more 
understandable to the average user, one will not need a degree to 
grasp what is happening, and computer jargon will be kept to 
minimum levels. 

Good Luck. 
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Machine Code 
from Basic 

The Basic language is generally the simplest way of writing 
programs, it is easy to follow and debugging a faulty program is 
usually made quite easy with the editing facilities for altering 
lines in a program, so why use machine code? 

The main reason must be speed of execution, not purely based on 
games programs such as space invaders or the like which would not be 
worth playing if they were written in Basic, but more serious 
applications which will be shown in the book. In order to grasp 
some idea of the speed of a program written in assembler we will 
compare the execution time with a similar program written in 
Basic.: - 

10 SCREENOrKEYOFF 
20 WIDTH40:CLS 
30 TIME= 0 

40 FOR X = 0 TO 959 
50 PRINT"B"; 

60 NEXT 
70 PRINT TIME 

Now entering the function key 'F5' or by entering 'RUN' followed by 
the 'RETURN' key one will see that the MSX took 151 time cycles (or 
3.02 seconds if line 70 was altered to TIME/50) to fill the screen. 

Another method for displaying characters is to VPOKE directly to a 
specific location on the screen. In screen 0 mode the top left 
position of the 40 column screen is 0000 hex, let us alter the above 
program so that instead of printing one character after another 
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using the Basic PRINT statement we shall print the characters 
directly to the screen area of memory using the VPOKE statement. 

Add line 15:- 

15 Z = &H0 

And alter the following lines to read:- 

50 VPOKEZ+X,66 
70 LOCATE,23:PRINT TIME 

Once again Run the program. 

The time was 225, so directly VPokeing to the screen is no quicker. 
Note that the cursor remains in the same position whilst a VPOKE 
statement is carried out, therefore line 70 repositioned the cursor 
to screen line 23 by the LOCATE statement. If you find that the 
'Ok' is displayed slightly off-screen then enter in direct mode 
'WIDTH37' and the 'RETURN' key to clear the screen and return to 37 
column display which is the condition the MSX wakes up in when first 
switched on. 

Now if that program, although not the most interesting in the world 
but quite effective as an example, is re-written in machine code and 
called by the A=USR(0) function from Basic the dramatic increase in 
speed will be instantly obvious. 

Program 1 Direct Screen Addressing from Basic 

Assembly language instructions used:- 

LD HL,nnnn LD BC,nnnn LD A,nn CALL nnnn RET 

These instructions are detailed in chapter 2. 

Enter 'NEW' and 'RETURN' and input the program:- 
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10 CLEAR 200, &H9FFF 

20 FOR X = &HA000 TO &HA00B 

30 READ A:POKE X,A:NEXT 

40 DATA 62,66,33,0,0,1,192,3,205,86,0,201 
Enter 'F5' to run the program. 

The screen will instantly display the 'Ok' message and one could be 
excused in thinking that not much has just happened. But happen it 
has in that now a machine code routine has been placed in memory, 
starting at location A000 hex (40960 decimal), which will print the 
entire screen with the letter 'B' in a fraction of the time taken 
previously using normal Basic PRINT or VPOKE statements. 

Enter 'NEW' and 'RETURN' and this program will fill the screen:- 

10 DEF USR=&HA000:SCREEN0 
20 TIME=0 
30 A=USR(0) 

40 LOCATE,23:PRINT TIME 
RUN the program. 

Its speed is amazingly fast and time was printed as 1 or 2. 

As will be seen in the next chapter Assembly language is made up of 
several registers which we load with addresses and values, you can 
also check the codes in the Appendix. If we disassembled the DATA 
which was placed at A000 to A00B it would look like this:- 



1 

A000 

3E 

42 


LD A,42H 





2 

A002 

21 

00 

00 

LD HL,OOOOH 





3 

A005 

01 

CO 

03 

LD BC,03C0H 





4 

A008 

CD 

56 

00 

CALL 0056H 





5 

A00B 

C9 



RET 




We 

POKEd the 

DATA into 

memory starting at address 

A000 hex 

which 

if 

we 

convert to 

decimal 

gives 

us 40960 

, use the conversion 

chart 

in 

the 

Appendix 

if you aren 

't 

sure. 

The first two 

items in 

the DATA 
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line were 62,66 decimal. 62 converts to 3E hex which means we want 
to load the A register with the value of the next byte which in this 
case was 66 (42 hex) in line 1 on the previous page. 

The next three bytes were 33,0,0 which convert to 21,00,00 hex. 21 
hex signifies Load the register pair HL with the following two bytes 
in reverse order, low address first, in this instance we want to 
load HL with the address of the top left corner of Screen 0 (Video 
RAM) which is 0000 hex, therefore in this particular case reverse 
order doesn't show us much as the address is zero but the next line 
will prove the point. 

These were followed by 1,192,3 and the number 1 signifies Load BC 
with the following two bytes in low byte first, high byte second. 
The figure we want to load into BC is the amount of bytes we wish to 
print to the screen. Screen 0 has a maximum size capacity of 960 
locations, 24 lines by 40 columns, therefore 960 decimal equals 03C0 
hex, which in reverse order becomes CO 03 (line 3). 

Next came 205,86,0. 205 converts to CD hex which translates to CALL 
the address of the next two bytes which were in reverse order again. 
The address of the routine we wish to call is 0056 hex therefore if 
we reverse them and convert to decimal these become 86,0. 

NOTE The ROM section of memory contains many routines which can be 
called upon to perform different functions, location 0056 hex 
contains the instruction to jump to a routine which fills VRAM area 
with the character contained in the A register. However before 
calling the routine one must ensure that HL contains the start 
address, BC the number of bytes to fill and A the data. And this 
our program has already done in lines 1 to 3. 

The final number in the DATA line was 201 which converts to C9 hex, 
this command is RET for return, just as one would use after a GOSUB 
routine in Basic. Remember that we went to this routine by the 
USR(0) statement which is a Call instruction just like the Basic 
GOSUB and to quit the routine we enter the RET command to return. 
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The USR statement can contain within the brackets an 'argument' such 
as an integer, string, single or double precision variable to pass 
on for the machine code program to use. This is explained in 
chapter 4, but for this example no data was required to be accessed 
by our routine so a simple call was made with a dummy argument (0). 

Now that routine although it executed in a fraction of the time it 
took using Basic was not quick to program, and a lot of thought 
would go into producing a simple output such as that. It is also 
more complicated translating decimal values back to hex and then 
translating them into assembly language Mnemonics and operands. 

In later examples of machine code we will use an Assembler, Editor 
called 'ZEN - Z80 Assembly Language Programming System for the MSX 
Micro-Computer' which includes a disassembler. An Assembler/Editor 
will do most of the dirty work for you and produce a printout such 
as we have just seen, furthermore entering assembly language is made 
childs-play, well almost, as they allow one to enter opcodes and 
operands such as:- LD BC,O3C0H directly. After entering the listing 
one selects the assemble option and the assembler will then 
translate all the instructions into machine code automatically and 
output a version known as Object code. This small piece of jargon 
simply means assembled machine code ready to record on tape for 
future loading. 

It is virtually impossible to write machine code programs of any 
size without an assembler, it will pick up any false statements just 
like Basic does with the Syntax errors and it will allow one to run 
the programs and use breakpoints to stop the running at certain 
points so that one may check on the state of the registers etc. 
This is most important as the programs run so fast it would be 
difficult to make these checks without the facility. 
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Program 2 


Storing Screens 


New Assembly language instructions used:- 

LD DE,nnnn 

Two other routines within ROM allow the screen area to be copied 
into other parts of memory for storage and recalled when required. 
One may have a program which is menu driven in which options the 
user can make are listed on screen. That complete screen display 
could be stored somewhere in RAM and when needed a A=USRn(0) 
instruction will immediately transpose that block of memory back to 
the screen in a flash. 

Enter 'NEW' and 'RETURN' 


10 CLEAR20 0,&HDFFF 

20 DEF USRO=&HFOOO:DEF USR1=&HF010 
30 FOR X = &HF00 0 TO &HF00C 
40 READ A:POKE X,A:NEXT 

50 DATA 33,0,0,17,0,224,1,192,3,195,89,0,201 
60 FOR X = &HF010 TO &HF01C 
70 READ A:POKE X,A:NEXT 

80 DATA 33,0,224,17,0,0,1,192,3,195,92,0,201 


Now enter the 'F5' key or 'RUN 1 and 'RETURN' 

Once again the 'Ok' message was displayed almost immediately, and 
we now have this screen move routine in memory. 


One does not need to write a separate program to demonstrate this 
routine, providing there is a fair amount of text presently on the 
screen, if there isn't put something on the screen, anything. 

Enter in direct mode (without a line number) A=USR0(0) and 'RETURN'. 
The 'Ok' will be displayed instantly and the total displayed area 
has been copied into memory locations E000 to E3BF hex. It has not 
disappeared off the screen it has been duplicated into the other 
area. If one was running a program the screen could now be cleared 
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and the program continue until one needed to bring back the previous 
display. 

Now clear the screen by entering the 'SHIFT' and 'HOME' keys and to 
prove the point enter some characters onto the screen, it does not 
matter if one gets 'Syntax error' printed just get something on the 
screen. 


Enter in direct mode A=USR1(0) and 'ENTER 1 

The screen will instantly change back to the previous display which 
was saved when we entered A=USR0(0) 

One could save more than one screen, providing they were moved to 
separate areas of memory, the Screen 0 text screen can contain up to 
960 bytes so one will need to adjust the program for different 
storage areas. Here is the assembled listing, remember it was in 2 
sections the first stores a screen:- 


1 

F000 

21 

00 

00 

LD HL,0000 

2 

F003 

1 1 

00 

E0 

LD DE,EOOO 

3 

F006 

01 

CO 

03 

LD BC,03C0 

4 

F009 

CD 

59 

00 

CALL 0059 

5 

F00C 

C9 



RET 

second section 

recalls 

it to the di: 

1 

F01 0 

21 

00 

E0 

LD HL,E000 

2 

F01 3 

1 1 

00 

00 

LD DE,0000 

3 

F01 6 

01 

CO 

03 

LD BC,03C0 

4 

F01 9 

CD 

5C 

00 

CALL 005C 

5 

F01C 

C9 



RET 


The ROM routines which control the copying are at 0059 and 005C hex 
and as with the previous example certain registers need loading with 
data before they are called. Whether storing or recalling a screen 
of information registers HL require the source address. When 
storing a screen in the Screen 0 mode we know that the source will 


7 




be address 0000, so in line 1 HL is loaded with 0000. DE represents 
the destination address and is loaded with the start address of 
where in RAM we wish it to be stored from, so in line 2 DE is loaded 
with E000 hex. Registers BC always contains the amount of bytes to 
move and is loaded with 03C0 hex (960 decimal) in line 3, if one 
wished to only store the top half of a screen, say lines 0 to 11, BC 
could be loaded 480 (01E0 hex). Line 4 is the call to the ROM 

routine which carries out the copying and this is followed by RET in 
line 5 which returns us to our Basic program. 

The second section for recalling a stored screen works in a similar 
fashion with only alterations to HL, which contains the source 
address, and is loaded with the start of the storage area E000, DE 
for the destination which in Screen 0 will be the 0000, and finally 
the call to execute the copying back to screen which is at 005C. The 
amount of bytes to transfer, in BC, remains the same at 03C0. 

As we now have the facility to store and recall one screen display 
it is straightforward to modify the program to cater for four 
screens. One only needs to alter various items in our basic program 
which wrote this machine code routine into memory. 

List the program and alter the following lines to read thus:- 

20 DEF USR2 =&HF020:DEF USR3=&HF030 
30 FOR X = &HF020 TO &HF02C 
60 FOR X = &HF030 TO &HF03C 

And in line 50 alter the sixth number from 224 to 228 
and line 80 alter the third number from 224 to 228 

NOTE Care must be taken when modifying an existing line on screen. 
In lines 50 and 80, which exceed one screen line, ensure that you do 
not press 'RETURN' until you have moved the cursor to the end of the 
complete program line otherwise the MSX will forget the characters 
shown on the next line and shorten the line so producing an error 
message. List the program before running it. 
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After running the altered program one should have the facility to 
store another screen display in memory, only this time we have 
written the copying routine at F020 and the recall routine at F030 
hex, and the storing of this second screen commences at E400 hex. 
Storing a second screen is achieved by entering:- 
A=USR2(0) 

and to recall to the display:- 
A=USR3(0) 

If one requires three screens to be stored the following alterations 
should be made:- 

20 DEF USR4=&HF040:DEF USR5=&HF050 
30 FOR X = SHF040 TO &HF04C 
60 FOR X = &HF050 TO &HF05C 

And in line 50 alter the sixth number from 228 to 232 
and line 80 alter the third number from 228 to 232 

Check the listing and run. 

And these are the alterations for the fourth screen:- 


20 DEF USR6=&HF060:DEF USR7=&HF070 
30 FOR X = SHF060 TO &HF06C 
60 FOR X = &HF070 TO &HF07C 


And in line 50 alter the sixth number from 232 to 236 
and line 80 alter the third number from 232 to 236 


Once again list and run the program. The routines are accessed by:- 


A=USR0(0) stores- 
A=USR2(0) " " 

A=USR4(0) " " 

A=USR6(0) " " 


A=USR1(0) recalls 
A=USR3(0) " " 

A=USR5(0) " 

A=USR7(0) " " 
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2 

Z80 Instructions 


In this Chapter, we're going to take a broad look at the way the 
Z80 chip interprets the machine code numbers, the Z80 Registers and 
the way they are generally used, and then at the different types of 
Assembler instruction. You'll find a complete list of these mnemonic 
instructions in the Appendices - listed alphabetically and 
numerically by the first byte of their instruction code. There are 
several books available which explain each Z80 instruction in 
greater depth, rather like an encyclopaedia and almost as large, but 
these are general references and do not show examples for specific 
micros like the MSX range. However if one requires more detailed 
information regarding the Z80 instruction set then the purchase 
should prove worthwhile. 

BASIC has well over 200 instructions - taking into account all the 
subtle variations like 'IF-THEN GOSUB' and 'IF THEN PRINT'. Z80 
machine code has nearly 700 - but don't panic, many of them are 
simply variations on a theme. 

The difference, as you will have already appreciated, is that one 
BASIC instruction calls up a host of machine code instructions 
within the interpreter. When you write in machine code you have to 
generate those instructions yourself - although you can, of course, 
call up useful routines resident in the ROM section of memory (as 
indeed some of the demonstration programs in this book do). 
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It is possible to write programs without having a full knowledge of 
the entire instruction set - indeed many people do quite happily and 
successfully, adding to their knowledge as they gain experience. 
The same is true to some extent when programming in BASIC. 

For example - how would you do a count of 1 to 1000 in BASIC? 
Probably:- 

10 FOR 1=1 TO 1000 
20 NEXT 

30 PRINT "ALL DONE" 


Fine, but supposing you didn't know about FOR-NEXT loops? You'd 
probably tackle it this way:- 


1 0 A=0 
20 A=A+1 

30 IF A<1000 THEN 20 
40 PRINT "ALL DONE" 


But supposing you didn't know about IF-THEN constructions either. 
You'd really have to put your thinking cap on:- 

10 A=0 
20 A=A+1 

30 B=-1*(A<1000)-2*(A=1000) 

40 ON B GOTO 20,50 
50 PRINT "ALL DONE" 


As you can see, the programs become longer - and take longer to run 
- when the most suitable commands are not used. Knowing all the 
commands at your disposal helps you to make your programs shorter 
and/or faster running... and your life easier. Usually machine code 
programs run fast enough even when written the 'long way round', but 
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when a very large number of repetitive actions are involved, such as 
in a Chess Game program, even a few microseconds knocked out of a 
loop can result in a considerable time saving when the program is 
running. 

Having said that, the programs in this book have been written to 
demonstrate principles, and are not necessarily the fastest or 
shortest way of achieving the desired result. 


What do all the numbers mean? 

Machine coding, as you know, is all about numbers. A number can 
mean one of two things to the Z80 central processing unit in your 
computer. It can mean an instruction or part of an instruction to 
do something. Or it can mean a piece of information to be worked on 
or used in some way. Fortunately, the Z80 knows exactly which of 
these the number represents (in a correctly written program), and 
acts accordingly. 

Take an instruction to load Register A with the value '7' (we'll be 
discussing the Registers in more detail later). In Assembly 
language mnemonics this instruction is written LD A, 7 . In machine 
code language, the instruction is represented by the two hex numbers 
'3E 07'. When the Z80 sees the first of these it says "3E means I 
must load the next number along into Register A". It takes up the 
7, puts it into Register A, then looks to the number after the 7 for 
the next instruction. So it wouldn't be confused if it saw, for 
example, the two hex numbers '3E 3E' - this time it would load 3E 
hex (62 decimal) into its Register A, then look to the number after 
the second 3E for its next instruction. 

Note that each single byte of information can have a value from 0 to 
FF hex (0 to 255 decimal). Let us take a look at that in more 
detail. 

A byte consists of 8 bits, each bit being a binary 0 or 1 . So the 
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binary number 11001001 can be represented thus:- 

Bit No: 76543210 
Binary Value: 11001001 

Wherever a '1' appears in the binary representation, raise 2 to the 
power of the corresponding Bit Number, add the results together, and 
you have the decimal value of the Binary number. Thus, using the 
above example:- 

2 to the power 7 =128 

2 to the power 6 = 64 

2 to the power 3 = 8 

2 to the power 0 = 1 (any no. to the power 0=1) 


So the binary number 11001001 is 201 in decimal. 

To convert a binary number to Hex, split the eight digits into two 
groups of four (called 'nibbles'). Thus:- 

Nibble 'bit' no.: 3210 3210 

Binary value: 1100 1001 

Left side: 2 A 3 = 8 Right side: 2 A 3 = 8 
2*2 = 4 2 A 0 = 1 

12 9 


Remembering that decimal 12 = C in hex, the hex value of binary 

11001001 is C9. 
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How the Z80 handles 2-Byte numbers 


Many instructions to the Z80 tell it to operate not on one byte 
as in our 'LD A,7' - but on two bytes. For example, an Assembly 

instruction might be 'LD HL,49AFH' (the 'H' at the end tells the 
Assembler that 49AF is a hex number). Two-byte numbers increase the 
decimal values that can be represented from 0-255 to 0-65535 (0-FFFF 
hex) - which is absolutely vital for addressing or pointing to the 
memory locations in your computer. 


In the instruction LD HL,49AFH, we want the High byte, 49 (hex) to 
go into the H Register, and the Low byte AF (hex) to go into the L 
Register. The machine code instruction for loading H and L 
Registers with 'direct' data is 21 hex. When the Z80 sees 21 hex as 
an instruction, it takes the NEXT number and loads it into the L 
Register. That's right - the L Register. Then it takes the 
following number and loads it into the H Register. So the machine 
code for LD HL,49AFH looks like this:- 


21 AF 49 (hex) 


Note how, in actual machine code, the order of the two information 
bytes is reversed. Now you know why. 

When using an Assembler, you don't have to worry about this point 
- the Assembler sorts it out for you. But if you are entering 
machine code by hand, as was shown in chapter 1, forget the order of 
the two information bytes at your peril. 

Needless to say, when loading any Register pair with data (we'll 
discuss Register pairs later on), the Low byte always appears in the 
machine code listing before the High byte. In Assembly language 
remember, you write the number in the normal way, and let the 
Assembler put things in the correct order. 
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Inside the Z80 chip 


The elements that go to make up a Z80 chip include an Arithmetic- 
Logic-Unit, which performs all the (simple) arithmetical and logical 
functions, a 'control box' which makes sure data is passed in, 
decoded and acted on in the correct order, and a number of 8-bit 
(one byte) and 16 bit (two-byte) Registers. Just to confuse you, 
pairs of the one-byte Registers can also be used as two-byte 
Registers. 

The Program Counter 

Let us look first at the Program Counter (PC) two-byte Register. 
This holds the address of the NEXT instruction. It is automatically 
up-dated every time a new instruction is executed. However, the 
address it holds can be changed by, for example, a CALL instruction 
(like GOSUB in BASIC). 

In this case, the address in the Program Counter is put aside - on 
the STACK - and the address CALLed is put in the Program Counter in 
its place. When the CALLed routine is done it meets a RET (RETURN) 
command, which takes the two-byte number ON THE TOP OF THE STACK and 
puts it back into the Program Counter. Execution then continues 
from that address. If you use the Stack (and you will use it), it 
is important to remember that the next instruction address after a 
RETurn is taken from the top of the STACK. Many a program has gone 
wild because a number has been unwittingly left on the stack: on 
the other hand, the fact that you know that the address of the next 
(apparent) instruction is on the Stack can be useful when, for 
example, transferring data to a subroutine. 

A number of other instructions also affect the PC Register - jump 
instructions (JP or JR) for example. But for most instructions, the 
length of the instruction (including any information data elements) 
is added to the PC by the chip's control system, so that it knows 
where to look for the next instruction. 
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The Stack Pointer 


Another two-byte Register, the Stack Pointer (SP), keeps track of 
the top of the Stack - since many instructions enable you, as well 
as the Z80, to use the Stack. The Stack area is within the RAM of 
your computer - and an address is set up by the ROM routines when 
you switch on. 

You can if you wish set up your own address for the Stack but you 
must remember that the Stack runs BACKWARDS in memory, and it uses a 
last-in, first-out system. Think of it as a pile of plates, you can 
put plates on top or take them off the top, but you can't touch the 
plates anywhere else in the pile. 

The other point about the Stack is that it ALWAYS accepts or 
delivers two-bytes of data. So, if we put 11A0H, 22B0H and 33C0H on 
the Stack in that order, and the Stack Pointer is loaded with F090 


it will look 

like this:- 

Address 

Contents 

F08B 

CO 

F08C 

33 

F08D 

BO 

F08E 

22 

F08F 

AO 

F090 

1 1 


The Stack Pointer in the Z80 will be pointing to the last (low) byte 
of the 33C0H data. If another piece of two-byte data - say 4567H 
- is put on the Stack, the Stack Pointer is DECREASED by one 
(decremented), the first (high) byte 45 hex is put into the address 
now pointed to by the Stack Pointer (F08A), the Stack Pointer 
address is DECREMENTED again, and then the low byte of the data, 67 
hex, is put on the Stack (at F089). 

When taking data off the Stack, the system works in reverse. In our 
example, first the Low order byte (67 hex) is removed, the Stack 
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Pointer is INCREMENTED, the high order byte (45 hex) is removed and 
the Stack Pointer INCREMENTED again. So now the Stack Pointer is 
once again pointing to the low order byte of the 33C0 hex data. 

The 8-Bit Registers 

There are two sets of 8-bit Registers 
A, F, B, C, D, E, H, L 
and A',F , ,B , ,C , ,D , ,E , ,H , ,L' 

(Notice the F and F' Registers have been put next to the respective 
A Registers - that's because they are usually associated with the A 
Registers, and they have a function all of their own). 

Only one set of these Registers can be used at a time. Why have two 
sets? So that you can 'stop' in the middle of one operation, switch 
to the alternate set, carry out an intermediate operation, then 
switch back and continue with the original operation. There are 
several ways of passing data between one set and the other. 

Registers B and C, Registers D and E, and Registers H and L are also 
used as Register pairs to hold two-byte data. In a few commands, 
Registers A and F are also treated as a pair. 

The A Register 

The A Register is the Accumulator. It's where Almost All of 

the Action takes place. It is like Grand Central Station and in any 
program of consequence, it is kept extremely busy. Practically all 
comparisons, single-byte adding and subtracting instructions, and 
many special 'transfer' and 'load' instructions demand use of the A 
Register. God bless its cotton socks. 

The B and C Registers 

Several commands use the B Register or the B and C Registers 
together as a Byte Counter. (BC = Byte Counter - easy to remember). 
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Take for example the DJNZ Assembly command, which must always be 
followed by a Label. This instruction says 'Decrement whatever 
value is held in Register B by 1, and if it is NOT zero as a result, 
jump to the address denoted by the Label'. It's like a FOR-NEXT 
loop in BASIC, with the number of repetitions required being held in 
Register B. When B reaches zero, processing continues with the next 
instruction. (Note the mnemonic DJNZ = Decrement and Jump on Non 
Zero). 

Similar commands (e.g. 'LDIR') use Registers B and C as a pair 

- permitting for example the transfer of large or small chunks of 
data from one area in the computer to another extremely quickly. 
The number of bytes to be transferred in this way is held in the 
Register pair BC. 

Apart from these special uses, these two Registers can be used 
together or independently for your own requirements. 

The D and E Registers 

These too can be used independently, but are used together by some 
Z80 instructions to define a DEstination address. For example, the 
DEstination address of a block transfer of data (the 'LDIR' command 
again) is taken from Register pair DE: you have to put the address 
there, of course. 

The H and L Registers 

These Registers are used as a pair for quite a number of Z80 
instructions. In the 'LDIR' command, for example, the start address 
of data to be transferred is taken from the contents of HL Registers 

- so don't forget to put it there. You'll find that there are quite 
a few commands which allow you to use the HL Registers to 'point to 
data areas. 
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The F or 'Flag' Register 


This is a very important Register indeed. Unlike the other 8-bit 
Registers, you cannot load data into it in the normal way. Its 
purpose is to hold Flag results of any logic and arithmetic 
operation undertaken, and for some other instructions, to 'flag' a 
status. The important point is that some of the Flags can be 
'tested' to provide, for example, conditional jumps, calls or 
returns. 


NOTE THAT WHILE MOST OF THE INSTRUCTIONS AFFECT SOME OR ALL OF THE 
FLAGS, FLAGS REMAIN IN A CURRENT STATE UNTIL AFFECTED BY A 
SUBSEQUENT INSTRUCTION. This means the state of a Flag can be 
tested several instructions after the instruction that affected it 
- but do be sure that the intermediate instructions do not affect 
the Flag in question. This feature can help to reduce the amount of 
coding needed. For example, all but two of the 'load' instructions 
do not affect the Flags at all. So if one of two subroutines are to 
be called, depending on the status of a particular Flag, and if both 
subroutines require the same 'load' at their start, then the 'load' 
can be done before the conditional test is made. 


Certain bits of the Flag Register are allocated to specific 
functions, as follows:- 

Bit Number: 76543210 
Function: S Z - H - P/v N C 
Testable: * * * * 

The 'Testable' line indicates which of the Flags you can test in one 
way or another using the instructions available. Now we'll look at 
the functions of each one-bit flag. 
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The S or Sign Flag 

This Flag 'repeats' the value of the most significant bit in the 
result of an arithmetic or logic operation, including 'shifts'. When 
a byte is transferred into the A Register, it 'repeats' the value of 
the most significant bit of that byte. 

In many instances, bit 7 (the most significant) is used to indicate 
a particular condition. In 'two's complement' notation, for example 
(a brief discussion of which is given later in this chapter), bit 7 
represents the SIGN of the number. This means the binary numbers 
are only 7 bits long, but represent from -128 to +128. In this 
instance, Bit 7 is 'SET' (equal to a '1') if the number is NEGATIVE 
and 'RESET' (equal to '0') if the number is POSITIVE. Bit 7 of a 
data byte can also play a role when a program is 'communicating' 
with input/output devices, such as a Printer. The S Flag enables 
Bit 7 of such a byte to be tested. 

A number of Assembly commands allow the S Flag to be tested, by 
adding a 'P' (is it Positive?), or an 'M' (is it NEGATIVE?). The 
command JP (Jump), for example, can be turned into a CONDITIONAL 
jump by the addition of P - ' JP P,Label'. This tests the S Flag, 
and if it IS positive (i.e., equal to zero) as a result of some 
previous action, then the jump will occur. Otherwise processing 
continues with the next instruction. 


The Z or Zero Flag 

This Flag is used to indicate whether or not the result of an 
arithmetic operation is zero, or whether or not a 'comparison' test 
succeeds. 

When a result is Zero or a comparison test succeeds, the Z Flag is 
set to a '1'. Otherwise, it is reset to a 'O'. 

The Z Flag can be tested by adding 'Z' (is it Zero?) or 'NZ' (is it 
Non-Zero?) to certain Assembly commands. For example, 'RET Z' 
(RETurn on Zero) provides a conditional return from a subroutine, if 
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a previous operation has left the Z Flag set to '1', a RETurn will 
be made. Otherwise processing will continue with the next 
instruction. (As you can see, you don't have to worry too much about 
the actual value of the Z Flag bit - the Z80 looks at it and acts 
accordingly on your behalf). 


The H or Half-Carry Flag 

This Flag is used by the computer during Binary Coded Decimal 
arithmetic operations, to indicate whether or not there's been a 
carry from bit 3 to bit 4. It cannot be used in any conditional 
tests. 


The P/V or Parity Overflow Flag 

This Flag has three functions. Some instructions set or reset it 
according to whether the byte of a result has an even number of '1's 
(Parity Even = Flag set to "1"), or an odd number (Parity Odd = Flag 
reset to "0"). 

The second use of the P/V Flag is to indicate, during Binary Coded 
Decimal operations, whether or not Bit 7 (the 'Sign' Bit) has been 
affected by an overflow from Bit 6, thus accidentally changing the 
sign of the result. 

Finally, during block transfer instructions, such as 'LDIR', this 
Flag is used to detect whether the counter has reached zero. 

The Flag can be tested by adding 'PO' (is the Parity Odd?) or 'PE' 
(is the Parity Even?) to commands used to transfer program 
execution. For example, a CALL command can be turned into a 
conditional CALL if the Parity Flag is indicating 'odd', by writing 
'CALL PO,Label' instead of the unconditional command 'CALL Label'. 
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The N or Subtract Flag 

This Flag is used by the Z80 during its own Binary Coded Decimal 
calculations, and cannot be tested. 


The C or Carry Flag 

This Flag plays a dual role. First, it is used to indicate whether 
or not an addition or subtraction has resulted in a 'borrow'. If a 
borrow has occured, the Flag is set to "1". Otherwise it is reset 
to "0". Since comparison commands (e.g. CP B - which compares the 
contents of Register B with the contents of Register A) are achieved 
by subtracting the selected Register from Register A (and discarding 
the result), the Carry Flag can indicate whether the selected 
Register has a value greater than that in Register A (which produces 
a Carry), or has a value equal to or less than that in Register A 
(which produces a No Carry). Very useful. 

The second use of the Carry Flag is in many of the rotate and shift 
instructions - which move data along the byte one way or the other 
in a particular manner. For these instructions, the Carry Flag is 
used as a 'ninth' Bit. For example, the RRA Assembly command 
(Rotate Right the Accumulator - Register A), moves Bit 0 of Register 
A into the Carry Flag, moves whatever was in the Carry Flag into Bit 
7 of Register A, moves what was in Bit 7 to Bit 6 - and so on. Thus, 
this particular command effectively rotates the information held by 
the bits round one and includes the Carry Flag in the process. 


With logical commands AND, OR, XOR, the Carry Flag is always set to 
'O' (No Carry). AND A and OR A will leave Register A intact, since 
the Register is being ANDed or ORed with itself, whilst XOR A not 
only clears the Carry Flag but also clears Register A, as there can 
be no 'exclusive' bits if it is being XORed with itself. 

The Flag can be tested to produce conditional commands by the 
addition of 'C (Carry) or 'NC' (No Carry) to the command. Thus a 
CALL command can be turned into a CALL if the Carry Flag is set, by 
writing 'CALL C,Label' instead of 'CALL Label. 
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The following Table shows how the Flags are affected by various 
types of Command. Commands not listed - e.g. 'PUSH 1 and most 'LD' 
commands - do not affect the Flags at all. Please note that, where 
unnecessary, the 'Register' element of the Command has not been 
included in the Table: thus the OR command could be OR A, OR B, OR C 
and so on - all having the same effect on the Flags. Only those 
Flags that can be tested have been included. 

FLAGS 

C Z P/V S 

COMMAND 


ADD A,ADC,SUB,SBC, 





CP,NEG 

7 

? 

?v 

7 

AND,OR,XOR 

0 

? 

?p 

7 

INC,DEC 

- 

? 

?v 

7 

ADD RR,CCF 

7 

- 

- 

- 

RLA,RLCA,RRA,RRCA 

7 

- 

- 

- 

RL,RLC,RR,RRC, 





SLA,SRA,SRL,DAA 

7 

7 

?p 

7 

SCF 

1 

- 

- 

- 

IN 

- 

? 

?p 

7 

INI,IND,OUTI,OUTD 

- 

7 



INIR,INDR,OTIR,OTDR 

- 

1 



LDI,LDD 

- 


7 


LDIR,LDDR 

- 


0 


CPI,CPIR,CPD,CPDR 

- 

7 

7 

7 

LD A,I; LD A,R; 

- 

7 

IFF 

7 

BIT 

_ 

7 
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KEY: 

? = Depends on the result of the operation. 

?P = Depends on the Parity of result 
?V = Depends on overflow in result 
0 = Flag reset to zero 

1 = Flag set to 1 

= Flag unaffected: previous state retained 
IFF= Contents of interrupt flip-flop 

Where there are blanks, the Flags contain irrelevant information 


To summarise 

Relative 

and 

Z 

= 

If 

NZ 

= 

If 

C 

= 

If 

NC 

= 

If 

PO 

= 

If 

PE 

= 

If 

P 

= 

If 

M 

= 

If 


the conditional tests available for JumP, 
RETurn commands: 
result is Zero, act. 
the result is Not Zero, act. 
there's a Carry, act. 
there's No Carry, act. 

Parity is Odd, act. 

Parity is even, act. 

the Sign Flag is 'positive (S = 0), act. 
the Sign Flag shows a minus (S=1), act. 


CALL,Jump 


The index Registers IX and IY 

We now come to two very valuable 16-bit Registers in the Z80, the 
'Index' Registers. Unlike Registers A to F, there is no 'second 
set' of Index Registers: their contents are accessible to both of 
the A to F Register sets. 

The 'load' instruction commands related to these Registers can 
(indeed must, even if it's 0) include a displacement value. This 
enables, for example, data tables to be very easily set up, using 
the Register IX or IY to point to a 'base' address, and the 
displacement to point to the particular place required in the table. 

An example will help to explain this. Supposing we decide to have a 
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Table of information that contains a number of names, addresses and 
telephone numbers. We allocate, say, 20 bytes to cover the name 
data, 60 bytes to cover the address data, 12 bytes to cover the 
telephone number data. 

Our Table will then consist of a series of chunks, each 92 bytes 
long (20+60+12). We know that the telephone data for any name 
begins at the 80th byte from the start of the name. If we 'point' 
the IX Register to the start of the name in the Table, we know that 
the Telephone data will start at IX+80. This saves counting out the 
bytes to get to the correct address. A typical program might look 
like this:- 


LD B,11 
LD IX,NAME3 
LD DE,BUFFER 
GETTEL:LD A,(IX+80) 

LD (DE),A 
INC IX 
INC DE 
DJNZ GETTEL 
Next operation 

The first instruction sets up Register B as a counter. 

The second instruction loads up the IX Register with the 2-byte 
address we require - that for NAME3. 

The next instruction loads up Registers DE to point to a BUFFER 
area, where we want to hold the Telephone number - possibly for 
printing out. 

We then come to the start of a little loop which will collect the 
bytes of data from the Table. We collect one byte, then increment 
the value in the IX Registers, increment the value in the DE 
Registers (i.e move both to point to the next address along), then 
collect another byte and so on until our 'counter', B reaches zero. 
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Note that LD A,(IX+80) means load Register A with the data byte to 
be found at the address pointed to by IX+80. Similarly, LD (DE),A 
means load the data byte in A into the address held in the Register 
pair DE. 

The IY Register can, of course, be used in a similar way. As well 
as 'loads', the Index Registers can be used for ADD, INC, RLC, BIT 
and SET commands - INC (IX+80), for example, means go to the address 
pointed to by IX+80, and whatever byte is stored there, add one to 
it. 

How big can the displacement value be? Glad you asked - because the 
displacement value is treated as a signed number. That means it can 
be 7 bits long, with the Most Significant Bit representing the sign 
of the value. So, to answer your question, the displacement value 
can be anything from -128 to +127, 'O' being treated as a positive 
value. 


The I and R Registers 

Two more 8-bit Rregisters exist in the Z80 which can be accessed 
by commands. These are 'I', which stands for the Interrupt-Page 
Register, and 'R', which is the Memory-Refresh Register. 

The I register is used in a special interrupt mode of operation to 
which the Z80 can be set (by command), and it stores the high-byte 
of an address that will be called in the event of an interrupt 
process. The low-byte is generated by the device generating the 
'interrupt'. 

Let us briefly examine the concept of an interrupt. When you write 
a program, providing all is well, it will run the way you want it 
to, branching to subroutines and returning to the main program as 
scheduled. However, some input/output devices demand attention even 
while your program is running quite happily. The Video Display 
Processor' (VDP) in your MSX is one of these 'devices'. 
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An interrupt signal is sent by the device to the Z80. It says 'Hang 
on, I need attention'. Your 'main' program stops while the 
interrupt request is attended to - in the case of the VDP it is to 
'refresh' the screen display - and then control is passed back to 
the main program, to continue where it left off (see footnote). 

The programmer can call on the interrupt process himself, and 
indeed, you'll find a 'hook' at address FD9A and FD9F which is 
accessed 50 times a second. A Hook is 5 bytes in RAM which are 
initialised to Returns (they contain code C9 for RETurn) and the 
user can utilise these 5 bytes to do a CALL nnnn to his own 
interrupt routine and return to the main program. 

There are three interrupt modes, called up by the commands IM 0, IM 
1, and IM 2. In Interrupt Mode 0 - which is the mode your machine 
is in when you switch on - the external device must provide the 
instructions for what it wants the Z80 to do when it makes an 
interrupt request. 

In Interrupt Mode 1 (which is the mode the ROM places the Z80 within 
microseconds of you switching on), when an interrupt request occurs 
an automatic jump is made by the Z80 to memory address 38 hex. The 
current location of any program running at the time is, of course, 
temporarily stored so that after the interrupt routine is complete, 
a return can be made to the original program. This interrupt mode 
always calls to address 38 hex. On the MSX, 38 hex provides a jump 
to the Hardware Interrupt routines at address 0C3C hex. 


Footnote 

Users who require further information on the VDP should refer to the 
publication 'Behind the Screens of MSX Home Computers' by Mike Shaw, 
which examines in detail the operation of the VDP and the way it is 
used in the MSX. 
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The third mode operates in a similar manner, except that it starts 
by going to one of 128 addresses (instead of one), as supplied by 
the calling device in conjunction with the contents of the I 
Register. Note that bit 0 of the address byte from the calling 
device is always zero. 

The address pointed to, plus the next address, provide the 2-byte 
address of the interrupt handling routine, to which control is then 
passed. 

In some programs it may be necessary to ensure that an interrupt 
does not occur during a specific process: a Dissable Interrupt 
command (DI) lets you do this - but for heaven's sake remember to 
Enable Interrupts (El) again when that part of your program is 
complete. 

Finally, the Refresh 'R' Register: this is provided to refresh 
dynamic memories automatically. You can use this as a kind of 
'software clock', but since its values run only from 0 to 255 
decimal, it's not exactly the most useful Register available. 
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THE ASSEMBLY COMMANDS 


There are a number of ways to classify the many Assembly commands 
you have at your disposal. We are going to herd them together under 
five headings to cover instructions which: 

1. Transfer data from one place to another 

2. Manipulate and test the data in some way 

3. Re-route program running sequence 

4. Handle input/output devices 

5. System controls 


Before we go into the commands, it may be useful to spend a few 
brief moments looking at the way a command is carried out by the 
Z80. 

Every instruction is executed in three phases. In Phase 1, the 
instruction is fetched from the correct place in the program. The 
Program Counter tells the Z80 where to look (we dealt with this 
earlier). The first - perhaps only - byte of the instruction is 
then placed in a Register the Z80 keeps all to itself (called, 
believe it or not, the Instruction Register). In Phase 2, the 
instruction is decoded by the Z80 - that is, it sets up the cycle of 
operations for the third phase, which is to actually execute the 
instruction. 

Each phase operates within finite steps, called clock cycles or T- 
States. The cycles themselves operate in 'machine cycles' - called 
'M Cycles'. The shortest machine cycle lasts three clock cycles. 
Now as each cycle means a discrete unit of time, the more cycles an 
instruction needs for its fetching, decoding and execution, the 
longer it takes to execute. Pretty obvious really. 
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The point of all this is, generally speaking the more bytes there 
are to an instruction, the longer it takes to execute. However, the 
'complexity' of the instruction also plays a part, so some 
instructions take longer than others of the same byte length. For 
example, the one-byte instruction to Decrement Register pair BC 
DEC BC - takes 1 machine cycle, 6 T-States, while DEC A, also a 
one byte instruction, takes 1 machine cycle, 4 T-States. DEC A is 
faster by 2 T-States - or one miserable microsecond if the clock is 
'running' at 2 MHz. or even less at 3.58 MHz on the MSX. 


For the newcomer to machine coding, this discussion on machine 
cycles and T-States should be quite enough to cope with: it is 
beyond the scope of this book to discuss the actual speed of every 
instruction, since that becomes important only when one has gained 
experience. As mentioned before, most machine code programs run 
quite fast enough without any fine pruning. 


The 'Brackets' Convention 

Before we finally get down to the commands, there is one 
'convention' you must be perfectly clear about - and that is the use 
of 'brackets' within a command. 

An address can be referred to in two ways. If we want the address 
itself, it is written in the normal way - 1234H, for example. If we 
wish to refer to the CONTENTS of the address, then the address is 
placed in brackets. 

Thus the command 'LD HL,1234H' means 'load Registers HL with the 
address 1234 hex'. You will recall from an earlier discussion that 
the Low byte goes into Register L (34 hex), and the High byte goes 
into Register H (12 hex). 

The command 'LD HL,(1234H)', on the other hand, means 'go to address 
1234 hex, and whatever byte you find there, put it in Register L. 
Then go to the next address - 1235 hex - and put the byte you find 
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there into Register H'. (Look back a few pages to refresh your 
memory on how the Z80 requires addresses to be stored). So if 
addresses 1234H and 1235H hold bytes 89 hex and 67 hex respectively, 
then HL will be left holding the value 6789 hex after this command. 

Similarly, take the command 'LD A,(HL)'. This means 'go to the 
address pointed to by Registers HL, and put the byte you find there 
into Register A'. If the HL Registers had been 'set up' to hold 
1234H, then whatever byte is at that address (in our example above, 
it was 89 hex) is loaded into Register A. If HL Registers had been 
'set up' to hold 6789H, as in the second example above, then 
whatever byte is at the address 6789H gets loaded into Register A. 

Note that the command 'LD A,HL' cannot exist, since you will be 
trying to load two bytes of data into a one-byte store. Even an MSX 
computer can't do that. 


1. Data transfer commands 

In this section, we will be looking at all the different ways you 
can shift one or more bytes of data from one place in memory to 
another - and that includes shifting data around the Registers 
themselves. For convenience, it also includes the 'creation' of new 
data - that is, loading a Register with a specific value rather than 
a value to be found elsewhere in RAM. What we won't include in this 
section are the commands which read or write to input or output 
devices. 

You may think this an obvious point to make, but we'll make it 
nonetheless: data remains in an address or Register until it is 
'overwritten'. Thus, if we say 'Load Register A from Register B (LD 
A,B) then both Registers A and B will be holding the data that was 
in B, and the data that was in A will be lost. 
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All 8-bit transfers are achieved by a straightforward load 
instruction which takes the following format:- 

LD destination ( source 

Thus a typical example might be LD B,D - which means load the 
contents of Register D into Register B. 

The following table shows the 8-bit load commands available:- 



The Registers down the left hand side represent the DESTINATIONS of 
a load, and the Registers across the top represent the SOURCE of a 
load, in the command format 'LD destination,source'. The x's denote 
where a command is available. 
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So reading across the top line, you can have as valid commands: LD 
A,A; LD A,B; LD A,C; and so on. Notice that no command is 
available to load Register D from the address pointed to by Register 
pair BC (i.e. there's no LD D,(BC) command). Sad - but no problem. 

In the Table, 'nn' means a two-byte number, which could represent an 
address. You'll notice that only Register A can be loaded from the 
contents of a specific address (top line - LD A,(nn) ). Also, at the 
end of the Table, you'll see only Register A can be loaded into a 
specified address. Let's discuss the ramifications of this. 

If you want to load a specific address with a data byte, you can 
either do it by first placing the data byte in Register A (if it 
isn't already there), then do a 'LD (nn),A' command (nn being the 
required address). Or - take a look at the horizontal line for 
'(HL)'. If HL is loaded with the desired address - i.e. LD HL,nn 
(we'll come to that command later on), then data from any of the 
Registers A,B,C,D,E and yes, even H and L can be loaded into the 
desired address - using the LD (HL), 'register' command. 

If you study the Table, you'll see that the same applies 'in 
reverse' - that is, you can load any of the Registers (including H 
and L.) from the address pointed to by the HL Registers (vertical 
column (HL) ). Thus, you can write LD C,(HL) - meaning load 
Register C with the contents of the address pointed to by HL. Easy 
isn't it, when you know how. 

Now let's look at another aspect of this Table - that 'n' column on 
the right hand side. As you've probably already guessed, 'n' stands 
for a data byte - any value from 0 to FF hex or 255 decimal. 
Notice, now, how you can load a specific byte of data into the 
address pointed to by HL - the LD (HL),n command. 

You may wonder, looking at the table, how you can load for example 
the contents of Register D into an address pointed to by Register 
pair BC - that is, how do you cope without a command LD (BC),D. 
Well, good Register management, in the first place. But that isn't 
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always feasible. So you'll have to transfer the data in D to A 
(having first 'saved' A somewhere, if you want to keep it), using LD 
A, D; then simply use LD (BC),A. 

Four commands missing from the Table which were discussed earlier 
but will not be required for a while are:- 

LD A,X (load A from the Interrupt Register) 

LD A,R (load A from the Refresh Register) 

LD I,A (Load Interrupt Register from A) 

LD R,A (load Refresh Register from A) 

The 16-bit Load group 

The basic format for 16-bit (two-byte) data loads is essentially 
the same as that for 8-bit loads, namely:- 

LD destination, source 

There are however some important exceptions, which we will come to 
in a moment. Since we are talking about two-byte loads, either the 
source or the destination must, of course, be a Register pair. 

The following Table shows the commands available within the format 
'LD destination,source':- 


Source of the load 
BC DE HL SP IX IY nn (nn) 

Load Dest. 


BC 


X 

X 

DE 


X 

X 

HL 


X 

X 

SP 

X 

XXX 

X 

IX 


X 

X 

IY 


X 

X 


(nn) x x x x x x 
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Doesn't look a very busy Table, does it? It would appear that you 
can't - as an example - directly load Register pair BC from the 
contents of, say, Register DE. Appearances are correct: there is no 
LD BC,DE command. But as we shall see, this isn't really a problem. 

In the Table, 'nn' of course represents two bytes of data - which 
could be an address, or simply a number for some arithmetical 
operation - while '(nn)' represents the CONTENTS of address 'nn 1 . 

Probably the most important things to notice about this table are 
the absence of the A Register in a pairing, and the fact that the 
Stack Pointer Register, SP, can be loaded from the contents of 
Register pair HL, or the two-byte Registers IX or IY, or with an 
immediate address -'nn', or from the contents of a specific address 

- '(nn)'. So there are several ways to set up the Stack Pointer 

- or even to change it during a program (as long as you know what 
you're doing). 

The reverse isn't true, however: as far as load - LD - commands are 
concerned, the SP address can only be loaded into '(nn)' - to save 
its value. 

Now, what about the other ways we have to transfer two bytes of 
data, and what about the poor old A Register? What the Table could 
have shown is an extra column and an extra row headed (SP) - that 
is, for example, a LD (SP),BC command, or a LD BC,(SP) command. 
These functions are possible - but they are not invoked by this type 
of command. 

Let's see what LD (SP),BC means. '(SP)' means the contents of the 
address 'named' in the Stack Pointer Register. That's the top of 
the Stack. So 'LD (SP),BC' means - 'put the contents of Register 
pair BC onto the Stack'. Similarly, 'LD BC,(SP)' means - 'load 
Register pair BC from the contents at the top of the Stack'. In 
both instances, the address held in the Stack Pointer Register is 
'updated' after the transfer of each byte (see the earlier 
discussion on the Stack Pointer). 
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There is a command all of its own to put the contents of a Register 
pair on the Stack, and another command to take two bytes off. The 
commands are PUSH and POP, respectively. 

These are the Register pairs and two-byte Registers you can PUSH and 
POP:- 


AF,BC,DE,HL,IX,IY 

Thus, to store the contents of Register pair DE on the Stack, you 
can write PUSH DE. And to get the data at the top of the Stack into 
DE, you can write POP DE. 

You noticed, didn't you - Register pair AF can be PUSHed and POPed 
to and from the Stack. That's so you can conveniently put aside 
what may be important data in both or either the A Register and the 
Flag Register. 

Now, what about that poser we set earlier - loading BC from DE, for 
example. How do we do that? There are two ways. One, you can PUSH 
DE, then POP BC - that puts DE's data on the Stack, then reads it 
off into BC. Method two - use the two single-byte load commands, LD 
B,D; LD C,E. Both methods work, both methods are exactly two 
instruction bytes long, both methods are used quite extensively. 
But, the PUSH and POP method makes the Z80 look 'beyond' itself and 
into RAM area to execute the commands - whereas the LD 
Register,Register method doesn't. So the LD Register,Register 
method is faster (by 16 T-States, as it happens). If you want to 
put the two byte data that's in one of the Index Registers IX or IY 
into a Register pair, then you have no option but to go via the 
Stack. Notice, though, you do not specify the 'displacement' with 
the Registers: it's PUSH IX, not PUSH IX+d. 


36 




There are some more commands that enable you to shift two bytes of 
data from one place to another. They are called 'Exchanges'. Here 
they are:- 


EX (SP),HL 
EX (SP),IX 
EX (SP),IY 
EX DE,HL 
EX AF,AF' 

EXX 

An Exchange is different from a load, in that the contents of both 
places designated are 'swapped'. Thus, the first three commands 
swap the contents at the top of the Stack with the respective 
Register named - HL,IX or XY. 

For example, when a subroutine is called (through a CALL command) 
the address of the next instruction after the CALL is put on the 
Stack. That's the address that will be put back into the Program 
Counter when a RETurn is made from the subroutine. But supposing we 
choose to put after the CALL command not the next instruction, but 
an item or items of data that we wish to pass into the subroutine. 
In the subroutine, we do an EX (SP),HL command. So now what was in 
HL is on the top of the Stack, and what was on the top of the Stack 
- the address of where our data is - is in HL. We can pick up the 
data now by doing, for example, a 'LD A,(HL)' command. Now - and 
this is important - we increment HL so that it points (or ’bumps') 
over the information byte(s) to the address of the next instruction, 
and then do another EX (SP),HL. The correct address for the next 
instruction when we RETurn is now in the right place ready to be 
picked up by the Program Counter, and we've passed data into the 
subroutine for processing. That's by no means the only way to pass 
data into a subroutine, but it is a useful way. 

The EX DE,HL command is invaluable when doing arithmetical 
operations, or when you want to exchange a DEstination address in DE 
and a source address in HL. 


37 



The EXX command exchanges the contents of the three Register pairs 
BC,DE and HL with their counterparts in the second Register set 
- BC', DE' and HL'. But not, you'll notice, the AF Registers - they 
have their own command EX AF,AF'. The information contained in the 
second Register set is not worked on, merely 'held in abeyance', so 
you have another way of temporarily holding onto data without 
setting up storage addresses or using the Stack. However, you'll 
find in some computers, the second set is used quite extensively to 
handle interrupt routines and so on, so if you unwittingly wipe out 
or leave 'strange' data in the second set, you could have some 
peculiar things happening. 
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The Block Transfer Group 


We now come to the commands which enable any number of data bytes 
to be transferred from one place in RAM memory to another. These 
commands and their functions are:- 


LDI 

- Load (DE) 

from (HL) 


Increment 

DE and HL 


Decrement 

BC 

LDIR 

- Load (DE) 

from (HL) 


Increment 

DE and HL 


Decrement 

BC 


Repeat until BC = 0 

LDD 

- Load (DE) 

from (HL) 


Decrement 

DE and HL 


Decrement 

BC 

LDDR 

- Load (DE) 

from (HL) 


Decrement 

DE and HL 


Decrement 

BC 


Repeat until BC = 0 


All of these commands transfer the data byte found at the address 
pointed to by the Register pair HL, to the address pointed to by the 
Register pair DE. After each data transfer the value held in 
Register pair BC is decremented. (Obviously, these three Register 
pairs must therefore be 'primed' before the block transfer command 
is invoked). 

In the case of the LDI and LDIR commands, DE and HL are incremented 
after eafch transfer, while for the LDD and LDDR commands they are 
decremented after each transfer. Thus HL and DE are always left 
pointing to the correct addresses for the next data byte transfer. 
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With the LDIR and LDDR commands, the transfer of data continues 
until BC becomes zero, at which point processing continues with the 
next command. 

With the LDI and LDD commands, processing continues with the next 
command after each transfer: this enables other actions to be taken 
before the next transfer of data - though you must remember not to 
'upset' the values in the DE,HL, or BC Registers (unless that is all 
part of your cunning program). The LDI and LDD commands set the P/V 
Flag to zero if they decrement BC to zero. The following program 
will transfer only those data bytes that have their most significant 
bit (Bit 7) 'set' - that is, equal to '1': the program assumes that 
DE and HL have been set up with the Destination and Source 'start' 
addresses, and that BC is set to count the maximum number of bytes 
to be examined, and transferred if Bit 7 is equal to 1 1'. 


NEXT:LD A,(HL) 
BIT 7,A 
JR NZ,MOVE 
INC HL 
DEC BC 
TEST:LD A , B 
OR C 

JR NZ,NEXT 
JR DONE 

MOVE:LDI 

JP PE,NEXT 


;Get 'next' byte 

;Test top bit 

;Byte wanted - shift it 

;Byte unwanted - increment HL 

; and decrement the counter BC 

;Check if BC is zero 

;by ORing B with C 

;Do it again if BC not zero 

;BC is zero - so finish 

;Move the byte 

;Do again if BC not zero 


DONE:Your next command. 


Instead of the 'JP PE,NEXT' command after the LDI, one could do a 
relative jump back to the 'TEST' point - JR TEST - which checks if 
BC has reached zero after being decremented. But we wanted to 
demonstrate the use of the JP PE command. Note, incidentally, one 
cannot do a Relative Jump (JR Label) when testing for parity. But 
more about this, and the other commands 'BIT 7,A',INC and DEC later. 
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You may ask why do we need both LDIR and LDDR commands. It is so 
that we never 'overwrite' data we want to shift. 

Suppose for example we want to shift a data block of 1001H bytes 
from 8000H to 8500H. If we use the LDIR command with HL pointing to 
8000H and DE pointing to 8500H, the first byte will be transferred 
from 8000 to 8500H - overwriting data within the block of 1001H 
bytes we're going to transfer. 

In this instance, we would use the LDDR command - and set the HL 
Register to point to the END of the block we wish to shift (i.e. 
9000H), and DE to the END of the destination area (i.e. 9500H). So 
now, by the time DE has been decremented to 9000H, we've already 
shifted the data from there, so it's o.k. to overwrite it. 


2. Data manipulation & test commands 

The 8-Bit Arithmetic and Logic Group 


The simplest arithmetical operation that can be done on a single 
byte is to add one to it (INC) or deduct one from it (DEC). These 
operations can be performed on the following Registers and addresses 
pointed to by Registers:- 

A, B, C, D, E, H, L, (HL), (IX+d), (IY+d) 

The Z, P/V and S Flags are affected as a result of the operation. 

The rest of the operations in this section ALL operate on Register 
A: the OTHER data byte source - even if that is Register A as well, 

must be specified. The following sources can be used for the 
'other' data byte:- 

A, B, C, D, H, L, (HL), (IX+d), (IY+d), n 


41 










The 'n' of course represents a specific value. 


The commands available are:- 

ADD A; ADC A; SUB; SBC; AND; OR; XOR; CP 

We will examine each command:- 

ADD A (examples - ADD A,B; ADD A,(HL); ADD A,2) 

Note the A Register must be specified. This command simply adds the 
specified data byte to that in Register A. Thus ADD A,(HL) means add 
the contents of the address pointed to by HL to the contents of the 
A Register, leaving the result in the A Register. If the result 
exceeds FF hex (255 decimal), the Carry Flag is set, and A holds the 
result minus 256. Thus, with FF hex in Register A 'ADD A,2' would 
result in A holding '1 *, and the Carry Flag set to '1'. 

The Z, P/V and S Flags are also affected according to the result of 
the ADD operation. 


ADC A (examples - ADC A,B; ADC A,(HL); ADC A, 2) 

This is exactly the same as the ADD command, except that the 
contents of the Carry Register before the operation commences are 
also added to Register A. Thus if the Carry Flag is set and 
Register A holds 21 hex, 'ADC A,2' results in A holding 24 hex, and, 
because the operation did not require a 'carry', the Carry Flag 
would be reset to zero. 


SUB (examples - SUB B; SUB,(HL); SUB 2) 

Note that Register A is not specified (unless one wants to SUB A, 
i.e. subtract the contents of A from A). This command subtracts the 
specified data from Register A, and leaves the result in Register A. 
As with 'ADD', the Flags are affected according to the result. 
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SBC (examples - SBC B; SBC (HL); SBC 2) 

Similar to the SUB command, except that the contents of the Carry 
Flag are also subtracted from Register A. 

AND (examples - AND A; AND (HL); AND OFH) 

This performs a logic AND function between the A Register and the 
specified data byte, leaving the result in Register A. 

'ANDing' means 'compare the two bytes, bit by bit. If both bits are 
a 1, then the corresponding bit of the result will be a '1 1 . 
Otherwise it's 'O' '. 

Thus, with 0A7H in Register A, 'AND OFH' produces 

10100111 (A7 hex, 167 decimal) 

00001111 (OF hex, 15 decimal) 

Result = 00000111 (7) 

This technique is often used to provide a 'mask' - that is, to 
eliminate parts of a byte that are not wanted. The 'masking' data 
- in the above example 'OFH' - covers that part of the data byte we 
want to keep. 

ANDing always resets the Carry Flag to zero. Thus AND A will reset 
the Carry Flag to zero, and leave Register A as it was before the 
operation: this command can therefore be used to clear the Carry 

Flag without upsetting Register A. 

OR (examples - OR A, OR (HL), OR 80H) 

This performs a logic OR function on the A Register, leaving the 
result in the A Register. 

'ORing' means 'test the two data bytes, bit by bit. If either or 
both bits are a '1', then the corresponding bit in the result will 
be a '1'. Otherwise it's a 'O' ' 
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Thus with IB hex in Register A, OR 80H produces:- 

00011011 (1BH, 27 decimal) 

10000000 (80H, 128 decimal) 

Result = 10011011 (9BH, 155 decimal) 

This can be a useful way to add in bits to a byte: if A for example 
holds a value between 0 and 9, OR 30H will leave in A the ASCII 
code for that number. 

OR always clears the Carry Flag, and affects the other Flags 
according to the result. Thus, OR A leaves Register A unchanged, but 
clears the Carry Flag. 


XOR (examples - XOR A, XOR (HL), XOR 0FH) 

This performs a logic XOR function on the A Register, leaving the 
result in the A Register. 

'XORing' means 'compare the two data bytes bit by bit. If one is a 
1 1' and the other is a 'O', then the corresponding bit of the result 
will be set to a '1'. Otherwise it will be '0' '. Thus if Register 
A holds 14H, then XOR 17H produces 

00010100 (14H, 20 decimal) 

00010111 (17H, 23 decimal) 

Result = 00000011 (3) 

XOR always resets the Carry Flag, and affects the other Flags 
according to the result. XOR A must always result in Register A 
becoming zero - thus this is a useful command to clear Register A 
and the Carry Flag to zero: the Zero Flag will be set to '1' 
- meaning the value of Register A is zero. 


44 




CP (examples - CP B, CP (HL), CP 9) 

This subtracts the specified data byte from the value held in 
Register A - AND DISCARDS THE RESULT: thus, only the Flags are 
affected by the command. 

If the Test byte is greater than that in Register A, then the Carry 
Flag will be set. 

If the test byte is the same as that in Register A, then the Zero 
Flag will be set. 

If the test byte is equal to or less than that in Register A, then 
the Carry Flag is reset. 

The Sign Flag and the P/V Flags will be set or reset according to 
the value in Register A. 


The 16-Bit Arithmetic & Logic Group 

As with the 8-bit Group, the simplest commands in this Group are 
INC and DEC. These commands can be used to increment or decrement 
Register pairs:- 

BC, DE, HL 

and the 16-bit Registers:- 
SP, IX, IY 

Note however that, unlike the 8-bit INC and DEC, for the 16-bit 
versions, the Flags are completely unaffected. 

The following Table shows the ADD, ADC and SBC commands available 
(indicated by the x's):- 
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This 



with 


pair 

BC 

DE 

HL SP 

ADD 

HL 

X 

X 

X X 

ADD 

IX 

X 

X 

X 

ADD 

IY 

X 

X 

X 

ADC 

HL 

X 

X 

X X 

SBC 

HL 

X 

X 

X X 


Note that the SUB command is not available - the Carry Flag is 
always involved on a subtract operation. If you don't want the 
Carry Flag involved - in case it may be set to '1', use an OR A 
command first to clear it. 

The ADD, ADC and SBC functions are the same as those for the 8-bit 
commands except, of course, here they are operating on 16-bits. 


The 8-Bit Shifts and Rotates 


These commands operate on a specified byte of information, shifting 
or rotating its contents 'to the left' or 'to the right'. 

The byte operated on can be in:- 

A, B, C, D, E, H, L, (HL), (IX+d), (IY+d) 

The commands available are as follows:- 

RLC (Examples - RLC B; RLC (HL) ) 

This moves the contents of bit 0 to bit 1, bit 1 to bit 2 and so on. 
Bit 7 is moved into the Carry Flag AND into bit 0. The data is thus 
ROTATED Left, with the Carry Flag reflecting Bit 7. Note, for 
Register A the command can be written RLC A or RLCA: RLCA is a 

^^ffsrent command, requiring one less instruction byte. 
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RRC (examples - RRC B; RRC (HL) ) 

This moves the contents of bit 7 to bit 6, bit 6 to bit 5 and so on. 
The contents of bit 0 are moved into the Carry Flag AND bit 7. The 
data is thus ROTATED Right, with the Carry Flag reflecting bit 0. 
Note for Register A, the command can be written RRC A or RRCA: RRCA 
is the shorter, faster version of the two. 


RL (examples - RL B; RL (HL) ) 

This moves the contents of bit 0 to bit 1, bit 1 to bit 2 and so on. 
Bit 7 is moved into the Carry Flag, and the Carry Flag contents are 
moved into bit 0. Thus nine bits are involved in a ROTATE Left. 
Note that for the A Register this command can be written RLA instead 
of RL A, RLA being a shorter, faster command. 

RR (examples RR B; RR (HL) ) 

This moves the contents of the Carry Flag into bit 7, bit 7 into bit 
6 and so on. Bit 0 is moved into the Carry Flag. Thus nine bits 
are involved in a ROTATE Right. For the A Register, the command can 
be written RRA instead of RR A, RRA being the shorter and faster of 
the two commands. 

SLA (examples - SLA B; SLA (HL) ) 

This moves bit 0 into bit 1, bit 1 into bit 2, and so on. Bit 7 is 
moved into the Carry Flag. A 'O' is placed in bit 0. Thus the data 
is SHIFTED left. 


SRA (examples - SRA B; SRA (HL) ) 

This moves bit 7 into bit 6, bit 6 into bit 5 and so on. Bit 0 is 
moved into the Carry Flag. Bit 7 is 'refilled' with its original 
value (this is for 'signed' arithmetic' operations, to preserve the 
sign bit 7). Thus the data is SHIFTED right, arithmetically. 
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SRL (examples - SRL B; SRL (HL) ) 

This moves bit 7 to bit 6, bit 6 to bit 5 and so on. Bit 0 is moved 
into the Carry Flag, and a 'O' is placed in bit 7. Thus the data is 
SHIFTED right. 


Decimal Arithmetic Rotates 

We now come to two very special rotate functions, used when 
handling Binary Coded Decimal Arithmetic. Both commands operate 
between Register A, and the data byte in the address pointed to by 
the Register pair HL (i.e. ’(HL)'). They are:- 

RLD 

This command puts the bottom nibble (lower four bytes) of the A 
Register into the bottom nibble of (HL), the bottom nibble of (HL) 
into the top nibble of (HL), and the top nibble of (HL) into the 
lower nibble of Register A. The nibbles are thus rotated. The top 
nibble of Register A is unaffected by the operation. 


RRD 

This does the same as RLD, but in the other direction. Thus, the 
bottom nibble of Register A is moved to the top nibble of (HL), the 
top nibble of (HL) is moved to the bottom nibble of (HL) and the 
bottom nibble of (HL) is moved to the bottom nibble of Register A. 
The top nibble of Register A is unaffected by the operation. 
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BIT MANIPULATION 


Quite often, one wants to test a specific bit in a data byte, to 
see whether it’s a '1' or a 'O'. Equally it can be very useful to 
be able to set a specific bit to a '1', or reset it to 'O'. The Z80 
allows you to do this. 

The three basic command words available are:- 

BIT b,l: Test bit 'b' at location '1' 

SET b,l: Set bit 'b' at location '1' to a '1' 

RES b,1: Reset bit 'b' at location '1' to a 'O' 

The bit 'b' can, of course, be any bit from 0 to 7. (Remember that 
bit 7 is the most significant, and bit 0 is the least significant). 

The location '1' can be any of the following 

A, B, C, D, E, H, L, (HL), (IX+d), (IY+d) 

Thus there are three basic commands, each of which can operate on 
one of eight bits in ten different locations - a total of 240 
commands in all. Typical examples of the three basic commands are 
now given. 


BIT 3,B 

This tests whether bit 3 of Register B is a '0' or a '1'. If it is a 
'O', the Zero Flag is set to a '1' so that a subsequent test for 
Zero would succeed. Thus, in this program segment:- 

BIT 3,B 
JP Z.WASZERO 

a JumP will be made to the program segment labelled 'WASZERO' if BIT 
3 of Register B is 'O'. Otherwise, processing continues with the 
next command. 
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Note that whilst the Zero Flag is specifically set or reset by BIT 
commands, the Sign Flag 'S' and the Parity/Overflow Flag 'P/V' may 
or may not be affected - the information they contain is irrelevant 
and untestable. The Carry Flag is unaffected by the operation - it 
will contain a previously held value. 


SET 7,(HL) 

This command makes bit 7 of the data byte at the address pointed to 
by the HL Register pair equal to a '1'. 


RES 5,(IX+3 ) 

This command operates on the data byte at the address pointed to by 
the IX Register PLUS 3, resetting its bit 5 to a 'O'. Thus if the 
IX Register holds '8000H', then the data byte at address '8003H' 
will have its bit 5 turned into a 'O'. 

These bit manipulation functions can prove invaluable in some types 
of program. To give just one broad example, in an Adventure game 
one data byte may be used to indicate the possible exits from a 
given location - a 'O' meaning 'no exit', and a '1' meaning 'exit 
possible'. Bit 7 could represent North, bit 6 East and so on, with 
four bits 'left over' to represent say 'up', 'down' and two other 
possible ways out. Checking whether or not an exit is possible is 
then simply a matter of testing the appropriate bit: changing the 
status of an exit is simply a matter of 'SETting or RESetting it. 


50 




SPECIAL A and F REGISTER MANIPULATIONS 


There are five instructions which operate specifically on Register 
A or on the Carry Flag in Register F. These are as follows:- 

DAA 

This is a very special command for use when performing Binary Coded 
Decimal arithmetic (BCD). In BCD, a four-bit nibble is used to store 
one decimal digit: thus one byte can store two decimal digits (this 
is referred to as 'packed BCD'). The values '11' to '15' decimal 
can all be represented within one nibble: however, for BCD we only 
want one decimal digit per nibble, and so the binary representations 
of '11' to '15' decimal are meaningless and not wanted. 

Let us look at two examples. First, we will add '22' decimal to 
'43' decimal. The program to do this in Binary Coded decimal could 
be: - 


LD A,22H;22H = 0010 0010 binary,'22' in BCD 
ADD A,43H;43H = 0100 0011 binary,'43' in BCD 

As you can see, adding the binary values would yield 0110 0101 

- which in BCD is '65'. Just what we wanted, so there's no problem. 
Now let us look at what happens if we add '26' decimal to '17' 
decimal. Using the program segment as before, the binary 
representation for this would be:- 

0010 0110 (26H) 

0001 0111 (17H) 

and if we add these, we get 

0011 1101 (3DH) 

Here, the 'D' is meaningless as a decimal number. And that, patient 
reader, is where the DAA command comes in. Added after the 'ADD A' 
instruction in the program above, it Decimal Adjusts any result in 
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the A Register. Thus, in the first example, the 'DAA 1 command would 
do nothing, for all is fine and dandy. But in the second example, 
it would see that things have gone wrong with the lower nibble, sort, 
out exactly what had gone wrong (depending on whether we'd been 
adding or subtracting), and adjust the result accordingly. In the 
second example, it would leave Register A holding 0100 0011 - 4311 

or 43 in BCD - which is correct. In this specific instance it 
achieves this result by adding a further 6 to the lower nibble, but 
don't worry about that. Sufficient to know that it makes the 
correct adjustment. 

What you should know, however, is that to sort things out the DAA 
command makes use of the Flags - so after a DAA command, all the 
Flags are affected in some way. 


CPL 

This command 'complements' whatever value is held in the A Register: 
that is, every 'O' becomes a '1', and every 1 1' becomes a 'O'. Thus, 
if the A Register held the binary value '00101100', after a CPL 
command it would hold the binary value '11010011'. 

This is called the 'one's complement' of the number, and is a way of 
representing positive and negative values. For example, a '5' in 
binary is represented by '00000101'. On the other hand '-5' can be 
represented by the 'one's complement', namely '11111010'. Notice 
that bit 7 is now '1' - representing a minus value. (See also the 
discussion on Flags). 

The 'testable Flags are not affected. 


NEG 

In this command, the contents of Register A are subtracted from 
zero, and the resulting value is stored back in Register A. This is 
called the 'two's complement' of the number. 
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In two's complement representation, positive values are represented 
just as in 'one's complement' - i.e. in the usual signed binary way, 
with bit 7 showing the sign (0=positive,1=negative). Negative 

numbers however are represented as the 'one's complement' value PLUS 
one. Thus the two's complement of '-5' is '11111011'. 

Why go to all this bother? Two's complement makes signed arithmetic 
easier for the computer to handle. Consider the sum '3 minus 5'. 

00000011 (+3) 

11111011 (-5) 

Adding these (since we are representing the 'minus' as -5 in two's 
complement), we get:- 

11111110 

Here, bit 7 tells us the answer is negative. Taking the two's 
complement of 1111110, therefore, we get 00000010 (two's complement, 
remember, is the one's complement of 1111110, which is 0000001, plus 
1). Thus, the value is '2', and the Sign is negative. Answer, -2. 
Just what the doctor ordered. 

The Z80 command NEG, then, obtains the two's complement of a value 
in Register A and leaves it in Register A, thus saving the bother of 
doing a one's complement (CPL) and adding 1 (ADD A,1). This is a 
very scant description of the principles behind one's and two's 
complement arithmetic, but it should be enough to give the newcomer 
to machine coding an idea of what it's all about. 

Note that all the Flags may be affected by NEG command. 


CCF 

This command 'complements' the Carry Flag in the F Register. If the 
Carry Flag is 'O', then CCF makes it a '1'. If the Carry Flag is 
'1', CCF makes it 'O'. 
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SCF 

This command makes the Carry Flag equal to a '1 1 (i.e. Set Carry 

Flag' ) . 

There isn't a command to 'reset' the Carry Flag - that is, to clear 
it. However, as mentioned before, AND A and OR A will do this, 
without affecting anything else. XOR A clears the Carry Flag as 
well, but also clears Register A - makes it 'O' - and consequently 
also sets the Zero Flag and possibly affects the Sign Flag (which 
reflects bit 7, remember). Observant readers might see that an 
alternative way to clear the Carry Flag would be to set it first 
(SCF), then complement it (CCF) - but this takes two bytes of 
instruction code, whereas OR A takes one. So it's not much good as 
an alternative. But well spotted anyway. 
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BLOCK COMPARISONS 


The last 'manipulation and test' commands to be examined are the 
'block comparisons'. In many respects these are similar to the 
'block transfer' commands discussed earlier. They enable a whole 
chunk of data to be 'searched' to find a byte that is the same as 
that in Register A. Like the block transfer commands, they need you 
to set up the Registers first: HL with the start address of the area 
to be searched, BC with the number of bytes to be searched, and A 
with the data byte we're looking for. The commands are:- 

CPI Increment HL 
Decrement BC 

CPD Decrement HL 
Decrement BC 

CPIR Increment HL 
Decrement BC 

Continue until BC=0 or A=(HL) 

CPDR Decrement HL 
Decrement BC 

Continue until BC=0 or A=(HL) 

As with the block transfers, the CPI and CPD commands enable other 
operations to be undertaken within the 'search loop'. When a match 
is found, the Zero Flag is set. When BC reaches zero, the P/V Flag 
becomes 0 (Reset). 

The CPIR and CPDR commands whiz through the block to be searched 
until BC reaches zero, or a match is found. 

When a match is found, of course. Register pair HL will be pointing 
to the matching byte in the data block. 
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3. Re-routing program running sequence 


We now come to the commands which let you change the 'batting 
order 1 of your program instructions - the commands which emulate the 
'GOTO's 1 and 'GOSUB'S 1 in BASIC, and of course 'RETURN 1 . In machine 
coding, however, you have more scope. 

Jumps and Relative Jumps 

The BASIC 'GOTO' instruction can be emulated by a JumP (JP) or a 
Relative Jump (JR). A straight Jump is like a straight GOTO. The 
format is:- 

JP Label or JP address 

'Label' of course representing the label you have given at a 
particular point in your Assembly Language program, or which has 
been defined by an EQUate. 

Jumps can also be conditional - that is, any of the Flags can be 
tested, and the Jump made if the test succeeds. The format for this 
is: - 


JP cc,Label or JP cc,address 

where cc represents any of the Flag conditions that can be tested 
(e.g. NZ,Z,NC,C,PO,PE,P,M - see the section on ’Flags'). Thus a 
typical instruction might be JP NZ,ENDGAME, which means 'if the Zero 
flag is not set (non zero condition) - as a result of a previous 
operation - then continue processing from the address labelled 
ENDGAME'. 

Relative jumps need a little explaining. Their instruction codes 
are shorter than straight jumps. The address they provide a jump to 
is relative to the current address, and is given by a displacement 
value: consequently the actual address doesn't figure in the 
instruction code itself. If none of the addresses within the 
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the routine can be located 


routine itself are 'mentioned' directly, 
anywhere in memory. It is thus called a 'rellocatable' routine. 
Many programmers write small subroutines (to do specific functions) 
in a rellocatable form, so that they can add the routines to any 
major program they are preparing. All they need then is the 'start' 
point of the routine - which is done by a label. 

The format for a relative jump is:- 

JR Label or JR sc,Label 

where 'sc' represents a conditional test. Unlike Jumps, which can 
test any of the Flags, only the Zero and Carry Flags can be tested 
for a conditional relative jump - i.e. Z, NZ, C or NC. So you 
cannot write, for example 'JR M,LABEL'. 

The relative jump can be made forwards or backwards. The 
displacement value is in two's complement, and is added to the 
Program Counter plus 2. If you work it out, you'll find that 
relative jumps can be made to addresses within -126 and +129 bytes 
of the address of the first byte of the 'JR' instruction: 
fortunately, the Assembler calculates the displacement value for you 
when generating the machine code. 


Special Jumps 

There are four more kinds of jump you can do in machine coding. 
Three of these enable you to jump to an address specified in the 
Registers. They are:- 

JP (HL) 

JP (IX) 

JP (IY) 

and they're extremely useful when using 'jump tables'. One could 
for example have a data table of items, each item being three bytes 



long. The first byte of each item would be the 'menu selector 1 . 
The next two bytes would be the address (in the order Low byte. High 
byte, remember) of the 'action' routine for that menu item. The 
'menu selectors' through the table are searched (jumping over the 
next two bytes of the item where no match is found) until a match is 
found. 

With HL pointing to the matching byte, it is then a simple matter 
to: INC HL (so it points to the Low Byte of the action address); LD 
E,(HL) - pick up the low byte in E; INC HL - point to the High byte 
of the action address); LD D,(HL) - pick it up; EX DE,HL - put the 
address into HL; JP (HL) - and go. 

This procedure is just one of the many, many ways in which one can 
pick up the address of a required routine. It's also a fairly crude 
way, but it demonstrates a point. 

The fourth kind of jump emulates to some extent the 'FOR-NEXT' loop 
in BASIC. It is a type of Relative Jump, and has the format:- 

DJNZ Label 


For this instruction Register B is used as a counter, so you must 
set it up with a value equal to the number of times you want the 
operation done. At the beginning of the 'loop', you have a Label. 
When the DJNZ command is met, Register B is decremented and, if it 
is not zero as a result, a jump is made to the Label address. It is 
a Relative Jump, so the Label address must be within -126 and +129 
bytes of the DJNZ instruction's address (the Assembler calculates 
the displacement for you). 

You can jump out of the loop at any time - if a subsidiary test 
succeeds, perhaps. Register B will then be holding the number of 
operations left to do when the test succeeded - which may be useful 
information. 
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Calls 


A 'CALL' command is just like 'GOSUB' in BASIC. Like the JP jump 
command, it can be unconditional:- 

CALL Label or CALL address 

or conditional:- 

CALL cc,Label or CALL cc,address 

the 'cc' representing one of the Flag tests, just as for the 
conditional Jump command. 

When a CALL command is met, the Program Counter address for the next 
command is put on the Stack, ready for when a RETurn is made - we 
discussed this when reviewing the Registers of the Z80. You must 
therefore ensure that the Stack still has the RETurn address 'on 
top' when the RETurn is made (it's utter disaster if you don't). 

Restore 

There is another kind of special Call command, called RST - which 
stands for ReSTore. The format is:- 

RST a 

where 'a' stands for one of the following:- 

00H, 08H, 1 OH, 18H, 20H, 28H, 30H or 38H. 

When the RST command is encountered, the Program Counter address is 
put on the Stack (just as in a CALL command), and a jump is made to 
the specified address. The point about this instruction is that it 
is only one byte long, and provides an extremely fast jump. 
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You'll notice though that all the addresses concerned lie within the 
ROM area. So, for example, RST 00H gives you a cold start - like 
pressing 'reset', if your MSX has one. The other addresses provide 
jumps to specific routines used by MSX Basic, getting the next 
character in a Basic line of text, for slot management, for 
outputting to a currently operative device, and so on. 


Returns 

These RETurn control from a subroutine, just like 'RETURN' in 
BASIC. The format is:- 

RET or RET cc 

where 'cc' is one of the Flag tests, as for the jump (JP) and CALL 
commands. 

There are two special Return commands. The first is RETI (return 
from an interrupt), which must always be preceded by an El (Enable 
Interrupt) command. The second is RETN, which provides a return 
from a non-maskable interrupt, and resets the Z80 s interrupt Flag 
to the condition it held before the non-maskable interrupt was made. 


60 




4. Input/Output commands 


There are a number of commands available for inputs from or 
outputs to peripheral devices. In many ways most of these are like 
the block transfer commands, in that they enable blocks of data to 
be transmitted either automatically or within a 'loop 1 performing 
other functions. These particular commands are:- 

Input commands Output commands 

INI OUTI 

INIR OTIR 

IND OUTD 

INDR OTDR 

For the input commands, the peripheral device addressed by Register 
C is read , and the information is loaded into the address pointed 
to by Register pair HL. Then Register B is decremented, and 
Register pair HL incremented (INI, INIR) or decremented (IND, INDR). 

For the Output commands, the procedure is reversed - that is, the 
contents of the address pointed to by HL is output to the peripheral 
device addressed by Register C, B being decremented and HL 
incremented or decremented after each transfer. 

For the input or output commands ending with 'R', the procedure 
continues apace until B = 0. 

Four other input and output commands are available. These are:- 

Input commands Output commands 

IN A,(p) OUT (p),A 

IN r,(C) OUT (C),r 

IN A,(p) loads Register A with a byte of data read from the 
peripheral Port 'p'. Similarly, OUT (p),A outputs the data byte in A 
to the port 'p'. 


61 







IN r,(C) and OUT (C),r do the same kind of thing, except the port 
device is addressed by the C Register, and the specified Register 
'r' can be any of:- 

A, B, C, D, E, H, L 


5. System controls 

These commands are used for controlling the Z80 'system' 


NOP 

This means, quite simply, No Operation. That is, do nothing. Carry 
on with the next command you find. It's useful when writing programs 
in Assembly language, to provide a suitable spot for a 'Breakpoint . 
Since it takes time to 'execute', it can also be used to provide a 
very short (a very, very short) delay. 


HALT 

This shuts down the operation of the Z80 completely, until an 
interrupt is received, or a 'reset' performed. 


PI, El 

These Disable or Enable the Interrupt procedures, 
discussed in the section on the Z80 Registers. 


Interrupts are 


IM 0,1 or 2 

The IM commands set the Z80 in a particular Interrupt Mode. See the 
discussion on Interrupts in the section on Z80 Registers. 
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NON Z80 COMMANDS (Pseudo Ops) 


If using an Assembler, you'll find other commands are available 
which are essential for writing in Assembly Language. These are 
used by the Assembler to tell it what to do - reserve data space, 
assemble at a specific address and so on. They do not 'translate' 
into Z80 instruction codes, and will not normally appear in a 
disassembled listing. Please refer to the manual for your 
Assembler for details of these commands. 
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Line 1 of the program was an equate line and this simply tells the 
assembler that the Label 'LOOP' equates to A003H which is the 
address we wish to jump to at the end of the program as one can see 
in line 9 we have entered JP LOOP, we don't need to specify an 
address to jump to as the assembler has noted which address LOOP 
equals. One reason for these equates is that if we wished to alter 
the address at some future stage we would not need to list the whole 
program and alter each line which contained this address, all that 
is required is to change the first line to the different address and 
the assembler will do the work for us. This address is the warm 
start entry point to the ZEN Assembler, when this short program 
finishes running we need to tell the computer where to jump to and 
the mainloop of ZEN seems to be as good a place at this stage, we 
don't want the program running off wildly into memory. 

NOTE Whenever a hex number begins with a letter (A-F), as in 
this case, it must be prefixed with a zero as is shown in line 1 
otherwise the Assembler could confuse it for a label which always 
start with an alpha letter. Secondly a colon must be entered 
between the label and the letters EQU. 

Line 2 calls a ROM routine at address 0849H which simply clears the 
screen and returns to our program. This is similar to a GOSUB in 
basic but in this case the subroutine is already in ROM and all our 
program needs to do is call it. 

Line 3 loads the A register with the value of the letter 'A'. ZEN 
is quite versatile in that it allows entries within quotes and it 
simply converts this to the Hex equivalent value of the letter, in 
fact this line would have the same meaning if we entered LD A,41H 
which is how it would be assembled and loaded into memory by ZEN 
anyway. 41Hex is the hexadecimal ASCII value for the letter 'A', or 
we could have entered LD A,65 which is the decimal ASCII value of 
the letter 'A' and so omitting the suffix H which signifies to ZEN 
that the value is decimal and ZEN must convert it to Hex. 
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Line 4 contains the label NEXT as we will jump back here to continue 
printing letters. It is followed after the colon by CALL to 00A2H 
which once again is a subroutine in ROM which prints the ASCII 
value currently stored in register A, and returns to our program. 

Line 5 increments register A so the first time round after printing 
A on the screen we want it to increase its value by 1, so it will 
increase from 41H to 42H, the letter 'B 1 . 

Line 6 compares the value of register A to see if it has reached Z + 
1, and if it hasn't line 7 tests and jumps back to NEXT to do it all 
again. Once again it is easier to enter line 6 as "Z"+1 but when it 
is assembled this will be automatically altered to the ASCII Hex 
value of Z plus 1 making 5B hex. 

Line 7 is the relative jump and here one can see the advantage of 
giving lines a label for one does not need to calculate the number 
of bytes to jump back as the assembler does it for us. Furthermore 
one could add extra lines between 4 and 7 which will obviously alter 
the amount of bytes to jump back over without the need to adjust 
anything else as the assembler will adjust the relative jump 
automatically providing the jump does not exceed -126 or +129. 

Line 8 is only reached when register A equals Z+1, when the alphabet 
is completed, then line 8 loads register A with the ASCII code for a 
carriage return, which returns the cursor to the left most position 
on the line, and line 9 calls 00A2H again to print it. 

NOTE ASCII codes below 20 hex are control characters, for 
positioning the cursor etc., and can be used with a call to 00A2 
as was done with the alphabet. 

Line 10 loads A with the ASCII code for a line feed (0A) as not only 
do we require the cursor to return to the left of the screen we also 
want it to move down to the next line, so a further call is made to 
00A2 in line 11 to carry out the task. 
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Line 12 puts us back under the control of ZEN when the program 
finishes with a jump to Loop (A003H). 

The next task is to find out if we have entered the program 
correctly, some bright sparks may have noticed some errors already, 
as one will get errors when entering and it is better to discover 
some of the more common types of error messages at this early stage. 
Enter 'A' and 'RETURN', this tells ZEN we wish to assemble the 
program. 

The screen will prompt for an 'OPTION 1 which will determine if we 
wish to assemble to a printer by entering 'P', or 'e' for an 
external device, or by entering 'V' for video to print on screen the 
assembled version, or if we just enter the 'RETURN' key on its own 
it will be assembled internally only stopping at a line which 
contains any errors, which is the fastest option. So after the 
'OPTION' prompt enter 'RETURN'. 

The screen will display:- 

ORG i 

2 START:CALL 0849H 
ZEN > 

which simply means we did not enter the origin of the program, which 
is where in memory we want it to reside. This is obviously a major 
omission as the assembler must know where to place the program. 

Enter 'T' followed by 'RETURN' and the first line of the program 
will be displayed. 'T' is the target line you wish to be displayed, 
entering 'T4' would display line 4, whereas just entering 'T' on its 
own moves up to the first line. 

Entering 'E', as we did to begin entering the program, will let us 
enter extra program lines from the current line, which after 
entering 'T' will be line 1, and as we enter these extra lines all 
the lines already in the program will simply shift up a line, the 
existing line 1 will remain intact but will now become line 2 etc. 
We should also enter a line to determine where we wish the program 
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to load into memory once it is assembled, this does not need to be 
the same address as the ORG address, but to keep this program as 
simple as we can we will load in the same place. 

TO 

DISPLAYED ENTER 

ZEN > E 

1 ORG OEOOOH 

2 LOAD OEOOOH 

3 

ZEN > 

Note the full stop to bring us back into command level. 

Entering 'T' and 'RETURN' will display line 1:- 
1 ORG OEOOOH 
ZEN > 

Now entering 'PI 6' and 'RETURN' will list the program from line 1 
through to the end of the program which is always displayed as 
'EOF'. If one entered 'P8' only the first 8 lines would be listed, 
so if the whole program is to be listed ensure you enter 'P' 
followed by a value equal to, or larger than, the last line number. 
Notice that the original lines in memory have been moved up 2 lines. 

Once again enter 'A' and 'RETURN' followed by 'RETURN' in response 
to 'OPTION' prompt to see if our program is correct and will 
assemble. If one entered the program as shown it should stop and 
display:- 
HUH? 

6 NEXT:CALL00A2H 
ZEN > 

Faced with this error one must look at the line and discover the 
mistake because the prompt 'HUH?' does not tell us much, only this 
will happen many times when writing your own programs. The line 
looks O.K. but the fault lies in the basic fact that we did not 
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enter a space between CALL and the address. 

Enter 'N' and 'RETURN 1 and the line will be displayed with the 
cursor to the right of the line of characters 

6 NEXT:CALLO0A2H 

Simply delete the characters from the right, by using the 'BS 1 
backspace key as the cursor keys are inoperative under ZEN, until 
the cursor is over the first zero after CALL and enter a space 
followed by 00A2H and 'RETURN'. 

The line should now look like this:- 

6 NEXT:CALL 00A2H 

Entering 'A' followed by 'RETURN' twice should result in no error 
message this time and the 'ZEN' prompt should be displayed almost 
immediately on the next line, which tells us that it assembled O.K. 
and is loaded into memory. 

Enter 'GE000H' followed by 'RETURN' and the screen will display:- 

BKPT > 

this is asking us to enter a breakpoint in the program, for if one 
is testing certain parts of a lengthy program it can be halted at a 
specified address in memory, and control will pass back to ZEN. 
This can be very useful as machine code programs run so quickly that 
it is very hard to keep track of them. 

In this case we do not want to enter a breakpoint, so in response to 
the 'BKPT' prompt enter the 'RETURN' key. 

The screen should clear and this display should appear:- 

ABCDEFGHIJKLMNOPQRSTUVWXYZ 
ZEN > 

Don't expect too much from your first machine code program, this was 
only to demonstrate the principles in entering code, but now we have 
lost all the bugs it seems a good time to assemble the program onto 
the screen to see what has happened. Enter 'A' and 'RETURN 1 and this 
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time when prompted for 'OPTION' enter 'V' and 'RETURN' and the 
result should be as follows:- 


PAGE 1 




ORG 

0E000H 



LOAD 

0E000H 



LOOP: EQU 

0A003H 

E000 

CDC300 

CALL 

0849H 

E00 3 

3E41 

LD 

A, "A" 

EO 05 

CDA200 

NEXT: CALL 

00A2H 

E008 

3C 

INC 

A 

E009 

FE5B 

CP 

"Z" + 1 

E00B 

20F8 

JR 

NZ ,NEXT 

E00D 

3E0D 

LD 

A, ODH 

E00F 

CDA200 

CALL 

00A2H 

E01 2 

3E0A 

LD 

A, OAH 

E01 4 

CDA200 

CALL 

00A2H 

E01 7 

C303AO 

JP 

LOOP 



END 


ZEN > 





In the above program, due to its simplicity, we did not document the 
functions of any lines but in a longer program it will be essential 
to describe certain parts of the programs. Comments can be included 
in any line by simply entering a semi-colon followed by the comment. 
To add a comment to line 3 enter 'T3' and 'RETURN' followed by 'N' 
and 'RETURN' and line 3 should be displayed with the cursor to the 
right of the characters:- 

3 LOOP:EQU 0A000H 

add the following:- 

;JUMP ON END and'RETURN' 

This line when listed will now show the comments after the semi- 
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colon which will remind one at a future date what the line was 
achieving. Unlike Basic ZEN only allows entry on a single screen 
line therefore if one required additional space for comments a line 
may be entered with no instructions just a semi-colon followed by 
the comments, these will be used on subsequent listings for clarity. 
If one has a printer the assembled listing to 'P' for printer will 
show the comment fields after an instruction formatted to the right 
of the paper, but they will not be displayed on screen when 
assembling to the 'V' for video option due to the limitations of the 
37 column screen, unless they are entered on separate lines. 


Alterations and Additions 

If one followed and understood the instructions and how they worked 
try the following:- 

Alter the program to print the alphabet from Z down to A. 

Change line 5 to LD A,"Z" 
line 7 to DEC A 
line 8 to CP "a"-1 

This will initially load register A with letter Z and instead of 
incrementing in line 7 it will decrement, so the first time round 
the value in register A will reduce to the letter Y and so on. Line 
8 checks if has reached A-1 and if not loops back to print again. 


SCREEN MESSAGES 

One will almost certainly require messages and inputs to be printed 
on screen, and as this test program is short it is ideal for 
modifying quite simply. The first line after the Clear screen call 
is line 5, so enter ’T5‘ and 'RETURN' and line 5 will get 
displayed:- 

5 LD A,"Z" 

ZEN > 


72 




Entering 'E' and 'RETURN' will now enable one to add lines to the 
program, and move the existing lines up in memory. 

TO 

DISPLAYED ENTER 

5 LD HL,MESG1 

6 CALL 6678H 

7 

ZEN > 

These new instructions are thus:- 

LD HL,MESG1 loads register pair HL with the address in memory of the 
start of a screen message which will have the label MESG1 assigned 
to it. CALL 6678H is a ROM routine which prints, at the cursors 
current position on screen, the message which starts at the address 
stored in HL. The message, as you will see below, also contains any 
control characters to move the cursor which can be entered before or 
after the quotes containing the string. Furthermore the message 
must terminate with the NOP code (0) which is used as the 'End of 
String' marker. 

The next job is to enter MESG1 into our program. List the program 
on screen to discover the last line number, as it is here we will 
place the string of characters in our message. END should appear as 
line 17, so enter 'T17' and 'RETURN' followed by 'E' and 'RETURN' 

TO 

DISPLAYED ENTER 

17 MESG1:DB"TEST",ODH,OAH,0 

1 8 

ZEN > 

If your message was longer than can fit onto one line then finish 
the first line of the message by adding the closing quotes and 
continue the message on the following line making sure it commences 
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with 'DB'" and only enter ’,0' at the end of message. 

In order to run the program it must be assembled again, making sure 
no bugs have crept in. When assembling to the screen it will be 
seen that long messages are not printed in full to the right of the 
screen, however the bytes representing that message are entered into 
memory as will be seen on the left of the screen. If the MESG1 line 
was entered as shown above the display would actually cut off after 
the comma following 'ODH' 

Running the program can be entered as 'GE000H'. It will be seen 
that the screen clears and 'TEST' gets printed on the first line, 
and the alphabet gets printed, in reverse order, on the following 
line. One could have entered additional codes for line feeds OAH 
to print further down the screen. 

Ensure your program lists as below, as we shall alter it further. 

1 ORG 0E000H 

2 LOAD 0E000H 

3 LOOP:EQU 0A000H;JUMP ON END 

4 CALL 0849H 

5 LD HL,MESG1 

6 CALL 6678H 

7 LD A,"Z" 

8 NEXT:CALL 00A2H 

9 DEC A 

10 CP "A"-1 

11 JR NZ,NEXT 

12 LD A,ODH 

13 CALL 00A2H 

14 LD A,OAH 

15 CALL 00A2H 

16 JP LOOP 

17 MESG1:DB"TEST",ODH,OAH,0 
1 8 END 

EOF 
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USER INPUTS 1 


We will assume that we wish the user to input a number from 1 to 9 
in order for the alphabet to be printed several times. A routine 
exists within the ROM that will stop the program and wait for a key 
to be pressed before continuing and can be utilised quite simply. 

Alter line 17 by entering 'T17' and 'RETURN 1 followed by 'N' and 
'RETURN' to alter MESGl. With the cursor to the right of the line 
delete back with the Backspace key to the start of the string and 
alter the line to the following:- 

17 MESGl:DB"INPUT 1to9",OAH,ODH,0 

We also need to change the program to accept an input from the 
keyboard between 1 and 9. Enter 'T7' and 'RETURN followed by E 
and RETURN'. 


DISPLAYED 


TIMES:CALL 009FH 

CP 31 H 

JR C,TIMES 

CP 3AH 

JR NC,TIMES 

SUB 3 OH 

LD B, A 


A label must be added to the current line 14 as it will be required 
to loop back. Alter it to read:- 


14 START:LD A,"Z' 
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Line 7 (labelled TIMES) now calls a routine within ROM (009FH) which 
halts the program and waits for a key to be pressed. Once a key is 
pressed the subroutine returns to our program with the ASCII value 
of the key stored in register A. 

As we only require keys 1 to 9 to be accepted the contents of 
register A must be checked, and line 8 checks that the key pressed 
was equal to or greater than 31H, which is the ASCII code for the 
number 1 (check with the ASCII code table). It simply subtracts 
(temporarily) 31H from the A register and if it contained a lower 
ASCII code than 31H the carry flag will be set, hence line 9 is a 
relative jump back to line 7, for the processor to wait for another 
key to be pressed, if there was such a carry. 

Subsequently the program must now check for a higher key than 9. 
Line 10 compares for 3AH, which in the ASCII table will be seen to 
equal the colon which is one higher than 9. Line 11 is a 
relative jump back to line 7 if after subtracting 3AH from register 
A the carry flag is not set then the key pressed must have been 
equal to or higher than 3AH, which means the key was higher in the 
ASCII table than 9 and we must jump back and wait for another key. 

Assuming that a correct key was entered we now know register A 
contains a number between 31H and 39H and we must convert this to 
between 1 and 9, and line 12 does exactly that it subtracts 30H from 
register A leaving it with a value 1 to 9. 

Line 13 loads register B with the contents of register A, as B is to 
be the counter for the amount of times we will print the alphabet. 
There is one extra line. Enter 'T23' 'RETURN' and 'E' 'RETURN' 

TO 

DISPLAYED ENTER 

23 DJNZ START 

24 

ZEN > 
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This command was discussed in the 'Special jumps' section in chapter 
2 and is a unique Z80 instruction for the B register which 
decrements B and executes a relative jump back to wherever you 
nominate, to carry out the instructions in the loop again until B 
decreases to zero, similar to a FOR..NEXT loop in Basic. In this 
case it jumps back to line 14 which is labelled START. 


One will have to assemble the program before it is capable of being 
run. If errors occur during assembly refer back to the specified 


line and check it in this chapter, 
and for BKPT enter 'RETURN'. 

The assembled listing:- 


PAGE 1 


1 




ORG 

2 




LOAD 

3 



LOOP: 

EQU 

4 

E000 

CD4908 


CALL 

5 

E003 

2130E0 


LD 

6 

E006 

CD7866 


CALL 

7 

E009 

CD9F00 

TIMES: 

CALL 

8 

E00C 

FE31 


CP 

9 

E00E 

38F9 


JR 

1 0 

E01 0 

FE3A 


CP 

11 

E01 2 

3 0F5 


JR 

1 2 

E01 4 

D630 


SUB 

1 3 

E01 6 

47 


LD 

14 

E01 7 

3E5A 

START: 

LD 

1 5 

E01 9 

CDA200 

NEXT: 

CALL 

1 6 

E01C 

3D 


DEC 

1 7 

E01 D 

FE40 


CP 

1 8 

E01F 

20F8 


JR 

1 9 

E021 

3E0D 


LD 

20 

E023 

CDA200 


CALL 

21 

E026 

3E0A 


LD 

22 

E028 

CDA200 


CALL 

23 

E02B 

1 OEA 


DJNZ 

24 

E02D 

C30OA0 


JP 

25 

E030 

494E5055 

MESG1: 

DB 

25 

E03 4 

54203174 



25 

E038 

6F390A0D 



25 

E03C 

00 



26 




END 


To run enter GE000H RETURN 


OEOOOH 

0E000H 

OAOOOH ;JUMP ON END 

0849H 

HL,MESG1 

6678H 

009FH 

31 H 

C,TIMES 
3AH 

NC,TIMES 
3 OH 
B, A 
A, "Z" 

00A2H 

A 

"A"-1 
NZ,NEXT 
A, ODH 
00A2H 
A, OAH 
00A2H 
START 
LOOP 

"INPUT 1to9",0AH,ODH,0 
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USER INPUTS 2 


This section deals with user inputs of unspecified length, as 
against single key inputs, entering a string from the keyboard to be 
printed a number of times. 

In this example all addresses have been labelled, as one would when 
writing a longer program, and entering should be good practise at 
getting it right. Enter 'K' and 'RETURN 1 to kill the existing 
program followed by 'E' and 'RETURN 1 . 


TO 


SPLAYED 

ENTER 

1 

ORG 0E000H 

2 

LOAD 0E000H 

3 

LOOP:EQU 0A003H 

4 

;ROM ROUTINES 

5 

PTMESG:EQU 6678H 

6 

PINLIN:EQU 00AEH 

7 

CLS:EQU 0849H 

8 

INPBUF:EQU 0F55EH 

9 

CHGET:EQU 009FH 

1 0 

CHPUT:EQU 00A2H 

1 1 

;CONTROL CODES 

1 2 

BL:EQU 7 

13 

CR:EQU ODH 

1 4 

NEWLNE:EQU OAH 

15 

t 

1 6 

CALL CLS 

17 

LD HL,MSG1 

1 8 

CALL PTMESG 

19 

CALL BELL 

20 

CALL PINLIN 

21 

CALL CRLF 

22 

LD HL,MSG2 

23 

CALL BELL 
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24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 
ZEN 


CALL PTMESG 
TIMES:CALL CHGET 
CP 31 H 
JR C,TIMES 
CP 3AH 
JR NC,TIMES 
SUB 30H 
LD B, A 

AGAIN:CALL CRLF 
LD HL,INPBUF 
NEXTCH:LD A,(HL) 

CP 0 

JR Z,FINI 
CALL OUTPUT 
INC HL 
JR NEXTCH 
FINI:DJNZ AGAIN 
CALL CRLF 
JP LOOP 
/ 

;OUTPUT ROUTINES 
BELL:LD A,BL 
JR OUTPUT 
CRLF:LD A,NEWLNE 
CALL OUTPUT 
LD A,CR 

OUTPUT .‘CALL CHPUT 
RET 

I 

;MESSAGES 

MSG1:DB"ENTER A " 

DB"STRING",ODH,OAH,0 
MSG2:DB"INPUT 1to9",ODH,OAH,0 
END 


79 





Line 16 commences the program with a call to the clear screer 
routine, (CLS) assigned an address in the equates, at 0849H. The 
message to enter a string is loaded into HL and printed by a call tc 
6678H (PTMESG). 

Line 19 calls BELL which is entered in the output routines in line 
45 where register A is loaded with the desired character, in this 
case BL (7), and the program jumps to OUTPUT (line 50) where a call 
to CHPUT (OOA2H) outputs the contents of reg A afterwhich a return 
is made back to the next line (20). This line calls the ROM routine 
PINLIN (00AEH) which allows input from the keyboard until the 
'RETURN' key is pressed and stores the string in the input buffer 
(INPBUF) at 0F55EH. Line 21 calls the carriage return and line feec 
subroutine (line 47) where once again reg A is loaded with the ASCII 
value of the control character, first with NEWLNE (OAH), and is 
outputted by a call to OUTPUT in line 50. Line 51 returns to the 
line after the last call (line 49) where A is loaded with the CB 
code (ODH) and this time the program runs into, it does not call, 
line 50 to output the character in A once again. This time line 51 
will return to the program line after the original call (line 22) 
whereupon the second message is loaded into HL and is followed by a 
call to BELL and the message is printed in line 24. 

Lines 25 to 31 get a number from 1 to 9 as the previous program. 
Line 33 loads the start of the input buffer, where the string is 
stored, into HL and line 34 loads the first character of the string 
into reg A and it gets printed in line 37 which calls OUTPUT. Wher 
a string is stored in the input buffer the byte after the last byte 
of the string is loaded with a zero, therefore in line 35 we compare 
the contents of reg A for zero and if the test is positive a 
relative jump to FINI (line 40) is carried out in line 36. Line 38 
increments HL to move it up to the next character in the input 
buffer and line 39 jumps back to NEXTCH (line 34) to load the 
character into reg A once again and compare it with zero. 

Line 40 decrements reg B, which was set up as a counter, and loops 
back to line 32 (AGAIN) to print the string once more. Line 41 
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performs another line feed and carriage return before the program 
jumps back to LOOP (0A003H) the warm start address of ZEN. The main 
difference with the ZEN addresses 0A000 and 0A003 is that on 
completion a jump to OA003 will maintain the condition of the 
registers allowing one to enter 'X 1 and 'RETURN 1 to examine the user 
registers. Very useful when programs are playing up. 


The following assembled listing is reproduced using the 'P' option 
for printer, the main differences between this and the 'V' video 
option is that line numbers are included in the printout and the any 
comment fields are shown in full due to the additional columns being 
available. To run the program enter GE000H and 'RETURN' twice, 
afterwhich the screen will clear and the 'ENTER A STRING message 
will be printed. After one has entered a string of characters the 
'INPUT 1to9' message will be shown and on entering a value between 1 
and 9 the string will be printed. 

PAGE 1 


1 




ORG 

0E000H 

2 




LOAD 

0E000H 

3 



LOOP: 

EQU 

0A003H 

4 



;ROM ROUTINES 


5 



PTMESG: 

EQU 

6678H 

6 



PINLIN: 

EQU 

0 0AEH 

7 



CLS: 

EQU 

0849H 

8 



INPBUF: 

EQU 

0F55EH 

9 



CHGET: 

EQU 

009FH 

1 0 



CHPUT: 

EQU 

00A2H 

1 1 



;CONTROL 

CODES 


12 



BL: 

EQU 

7 

1 3 



CR: 

EQU 

ODH 

1 4 



NEWLNE: 

EQU 

OAH 

15 



/ 



1 6 

E000 

CD4908 


CALL 

CLS 

1 7 

E003 

2151E0 


LD 

HL,MSG1 

1 8 

E006 

CD7866 


CALL 

PTMESG 

19 

E009 

CD42E0 


CALL 

BELL 

20 

E00C 

CDAEOO 


CALL 

PINLIN 

21 

E0 OF 

CD46E0 


CALL 

CRLF 

22 

E01 2 

2162E0 


LD 

HL,MSG2 

23 

E01 5 

CD42E0 


CALL 

BELL 

24 

E01 8 

CD7866 


CALL 

PTMESG 

25 

E01 B 

CD9F00 

TIMES: 

CALL 

CHGET 

26 

E01 E 

FE31 


CP 

31 H 

27 

E0 20 

38F9 


JR 

C,TIMES 

28 

E022 

FE3A 


CP 

3AH 

29 

E024 

30F5 


JR 

NC,TIMES 
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30 

E0 26 

D630 


SUB 

3 OH 

31 

E028 

47 


LD 

B, A 

32 

E029 

CD46E0 

AGAIN: 

CALL 

CRLF 

33 

E02C 

215EF5 


LD 

HL,INPBUF 

34 

E02F 

7E 

NEXTCH: 

LD 

A,(HL) 

35 

E030 

FEOO 


CP 

0 

36 

EO 32 

2806 


JR 

Z,FINI 

37 

E034 

CD4DE0 


CALL 

OUTPUT 

38 

E037 

23 


INC 

HL 

39 

E038 

1 8F5 


JR 

NEXTCH 

40 

E03A 

1 OED 

FINI: 

DJNZ 

AGAIN 

41 

E03C 

CD46E0 


CALL 

CRLF 

42 

E03F 

C303A0 


JP 

LOOP 

43 



? 



44 



;OUTPUT ROUTINES 


45 

E042 

3E07 

BELL: 

LD 

A, BL 

46 

E044 

1 807 


JR 

OUTPUT 

47 

EO 4 6 

3E0A 

CRLF: 

LD 

A,NEWLNE 

48 

E048 

CD4DEO 


CALL 

OUTPUT 

49 

E04B 

3E0D 


LD 

A,CR 

50 

E04D 

CDA200 

OUTPUT: 

CALL 

CHPUT 

51 

E050 

C9 


RET 


52 



/ 



53 



;MESSAGES 



54 

E051 

454E5445 

MSG1 : 

DB 

"ENTER A 

54 

E055 

52204120 



"STRING", 

55 

E059 

53545249 


DB 

55 

E05D 

4E470D0A 




55 

E061 

00 



"INPUT It 

56 

E062 

494E5055 

MSG2: 

DB 

56 

E066 

54203174 




56 

E06 A 

6F390DOA 




56 

E06E 

00 


• 


57 




END 
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SAVING PROGRAMS 


Although one probably won't need to save this program on tape it 
is a good idea to use this small program to practise getting it 
right, it is not so straightforward as saving a basic program, so 
making mistakes now will be less costly than when your own machine 
code masterpiece is at stake. 

ZEN has 2 methods of saving machine code programs. The first is to 
save the source file as an ASCII text file. ASCII text files (or 
programs) are made up of the pure text which has been entered from 
the keyboard. One will require this option for saving unfinished 
programs, which obviously cannot be assembled in that state, for 
future loading using ZEN which would be achieved by entering 'R' and 
'RETURN' after the ZEN prompt. 

Entering 'H' and 'RETURN' will now display the start and end of the 
source file and the top of memory. At this stage the last program 
should display, if one hasn't added extra spaces or comments:- 

COOO C2A7 F37F 

If one enters 'QC000H' and 'RETURN' the text entered will be shown 
in memory byte by byte. To save an ASCII text file using ZEN enter 
'W' and 'RETURN' and one will be prompted for a file name, 
afterwhich it will be saved on tape as normal. Afterwhich one 
should verify the saved file. 

The second method is for saving the object file as a binary file. 
Binary files are the assembled program, and what gets saved is the 
pure machine code file, without comments, ready to run. In the last 
program it could be saved and then run directly from the loading, 
without ZEN being present, by simply BLOAD although one would need 
to alter line 42 from JP LOOP to RET as we would not require a jump 
to A003 if ZEN was not loaded. 
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To test that one is conversant in saving an binary file carry out 
the following 

Alter what should be line 42 to read:- 
42 RET 

One will need to assemble the program once again but if the above 
entry is correct that will take no time at all only this time 
assemble to the screen by entering 'V' and 'RETURN' as we MUST know 
the end address of the file. After altering line 42 the program 
will be 2 bytes shorter making the end of program E06CH. 

Place a fresh tape in the cassette and enter 'WB' which stands for 
write binary. One will be prompted for the START address so enter 
'E000H' and 'RETURN', it is important to enter the suffix 'H' 
otherwise ZEN will believe it is a decimal number which it is not. 

Next prompt is for the STOP address so enter 'E06CH' and RETURN' 
which is the last byte of the program. 

The next prompt is for the EXEC address which is where the program 
should run from. In this case we want to run from the same address 
as it loaded from so enter once again 'E000H', 'RETURN'. EXEC is 
added because a program does not always execute from its start 
address in memory. It may be that a program is written and then has 
some screen graphics titles added to the end of it but which one 
wants to run first, so the execution address could well be different 
to that of the loading one. 

This is followed by the LOAD prompt for the address at which it 
should load into, and again enter 'EOOOH 1 . 

The final prompt is for a file name, we could simply call this 
'TEST' and all that remains is to set the cassette to record mode. 

Once the file has been saved switch off the computer, wait a few 
seconds, (never switch off and on quickly) and turn it back on and 
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load the test program by entering:- 
BLOAD"TEST",R 

which after a few seconds, will automatically run if you saved it 
correctly, and when finished will jump into the Basic mainloop and 
display the 'Ok' message. 

Please understand that this was an exercise to correctly save and 
subsequently load and run machine code programs, which normally 
should be far more exciting than the Test program, and it is far 
less costly in programming hours to get it right at this stage than 
get it wrong and lose many hours work. 


CRASHES 


When testing programs in ZEN it is quite feasible that there may 
be something wrong with your program and it may crash, fall out of 
Zen's control, into Basic or even re-initialise and display the 
switch-on MSX screen message. One should be able to jump back into 
ZEN by entering 
DEF USR=&HA000 
A=USR(0) 

and hopefully ZEN, and your program, will still be in memory and 
debugging can continue. This may also happen when accessing Basic 
routines from a machine code program for if an error occurs the 
error trap routine within Basic could pick up the error, display an 
error message, and dump you into Basic s mainloop with the Ok 
message. To simplify the restoration one could enter the above 2 
lines with line numbers, making it a 2 line Basic program, and if 
the crash was not too severe entering the 'F5' key for Run should 
restore control to ZENs mainloop. 
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4 

MSX Routines 


This chapter demonstrates more routines which are provided in the 
ROM of the MSX and how to access them. 


TABLE CONSTRUCTION 

The following program uses keyboard input to produce notes in the 
range C to B in any of the 8 octaves, which gives it some appeal, 
but its main purpose is to demonstrate one method of accessing 
tables. The keys which will produce sounds are as follows:- 
R T U I O 
D F G H J K L 

The lower row are used for notes C to B whilst the keys on the top 
row signify the sharp keys (C+ etc). Pressing the '£' key exits the 
program. The Octave is set to 4 when the program runs but can be 
altered by entering keys 1 to 8 while it is running. 

The current note and octave are displayed on the screen. The 
program uses the Basic PLAY routine at 73E5H, therefore the string 
to be played must look as it would in a Basic program line with 
quotes (") surrounding it and, like the previously used print 
strings, must terminate with a zero value byte otherwise an error 

will occur and the program will drop into Basic and display an error 

statement. 

One should now be familiar with entering programs so only the 
assembled listing is shown, however the various ROM routines which 
are utilised are described after the listing. 
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1 




ORG 

0E000H 


2 




LOAD 

OEOOOH 


3 



QUIT: 

EQU 

0A003H 

;ZEN MAINLOOP 

4 



CHGET: 

EQU 

009FH 

;WAIT FOR KEY 

5 



CLS: 

EQU 

00C3H 

;CLEAR SCREEN 

6 



POSIT: 

EQU 

00C6H 

;CURSOR SET UP 

7 



PTMESG: 

EQU 

6678H 

;PRINT MESSAGE 

8 



CLIKSW: 

EQU 

0F3DBH 

;KEY CLICK SW 

9 



CHPUT: 

EQU 

00A2H 

;OUTPUT CHARACT. 

10 



ERAFNK: 

EQU 

OOCCH 

;ERASE FUNC KEY 

11 



CHSNS: 

EQU 

009CH 

;KEY SCAN 

1 2 

13 

E000 

CDCCOO 

i 

START: 

CALL 

ERAFNK 

;FUNC KEYS OFF 

14 

E003 

AF 


XOR 

A 

;ZERO A 

15 

E004 

32DBF3 


LD 

(CLIKSW),A 

; TURN OFF CLICK 

16 

E007 

CDC300 


CALL 

CLS 

;CLEAR SCREEN 

17 

EOOA 

2608 


LD 

H, 8 

;SET CURSOR COLUMN 

18 

EOOC 

2E02 


LD 

L, 2 

;SET CURSOR LINE 

19 

EOOE 

CDC600 


CALL 

POSIT 

;POSITION CURSOR 

20 

E01 1 

21CCE0 


LD 

HL,MESG1 


21 

E01 4 

CD7866 


CALL 

PTMESG 


22 

E01 7 

260C 


LD 

H, 1 2 


23 

E01 9 

2E0A 


LD 

L, 1 0 


24 

E01 B 

CDC600 


CALL 

POSIT 


25 

E01 E 

21EOEO 


LD 

HL,MESG2 


26 

E021 

CD7866 


CALL 

PTMESG 


27 

E024 

260E 


LD 

H, 1 4 


28 

E026 

2E0C 


LD 

L, 1 2 


29 

E028 

CDC600 


CALL 

POSIT 


30 

E02B 

21E9E0 


LD 

HL,MESG3 


31 

E02E 

CD7866 


CALL 

PTMESG 


32 

EO 31 

C34CE0 


JP 

PTOCT 

;PRINT OCTAVE VALUE 

33 

E034 

CD9C00 

INPUT: 

CALL 

CHSNS 

;IS KEY DOWN 

34 

E03 7 

28FB 


JR 

Z,INPUT 

;NO LOOP BACK 

35 

E039 

CD9FOO 


CALL 

CHGET 

;GET KEY IN REG A 

36 

E03C 

FE23 


CP 

II £ II 

; IS IT E KEY 

37 

E03E 

CA03A0 


JP 

Z,QUIT 

;YES FINISH 
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38 

E0 41 

FE31 


CP 

31 H 

; TEST FOR 1 

39 

E043 

38EF 


JR 

C, INPUT 

;IF LESS GET NEXT 

40 

E045 

FE39 


CP 

39H 

;TEST FOR 9 

41 

E047 

301 2 


JR 

NC,SAMOCT 

;STILL SAME OCTAVE 

42 

E049 

3295E0 


LD 

(OCTVE+1 ) , A 

;DISPLAY OCTAVE 

43 

E04C 

2615 

PTOCT: 

LD 

H, 21 

;POSITION CURSOR 

44 

E04E 

2E0A 


LD 

L, 1 0 

;TO PRINT OCTAVE No. 

45 

E050 

CDC600 


CALL 

POSIT 


46 

E053 

3A95E0 


LD 

A,(OCTVE+1) 

;NEW OCTAVE 

47 

E056 

CDA200 


CALL 

CHPUT 

;PRINT IT 

48 

E059 

1 8D9 


JR 

INPUT 

;GET NEXT KEY 

49 

E05B 

CD9000 

SAMOCT: 

CALL 

0090H 

;NO QUEUES 

50 

E05E 

47 


LD 

B, A 

;SAVE KEY IN B 

51 

E05F 

21A7E0 


LD 

HL,TABLE 


52 

E06 2 

7E 

COMPR: 

LD 

A,(HL) 

;TABLE IN A 

53 

E063 

FEOF 


CP 

0FH 

;END OF TABLE? 

54 

E065 

2 8 CD 


JR 

Z , INPUT 

;YES WRONG KEY 

55 

E067 

23 


INC 

HL 


56 

E068 

B8 


CP 

B 

;COMPARE KEY/TABLE 

57 

E069 

2804 


JR 

Z .FOUND 

;GO PLAY 

58 

E06B 

23 


INC 

HL 

;NOT FOUND. BUMP OVER 

59 

E06C 

23 


INC 

HL 

;NOTE STRING AND 

60 

61 

62 

E06D 

1 8F3 


JR 

COMPR 

;TEST NEXT IN TABLE 

E06F 

7E 

r 

FOUND: 

LD 

A, (HL) 

;NOTE TO PLAY 

63 

E070 

32A3E0 


LD 

(NOTE),A 


64 

E073 

23 


INC 

HL 


65 

E074 

7E 


LD 

A,(HL) 

;SECOND PART OF NOTE 

66 

E07 5 

32A4E0 


LD 

(NOTE+1),A 


67 

E078 

2193E0 


LD 

HL,STRING 

;HL=PLAY STRING 

68 

E07B 

CDE573 


CALL 

73E5H 

;BASIC PLAY ROUTINE 

69 

E07E 

2615 


LD 

H, 21 

;POSITION CURSOR TO 

70 

E080 

2E0C 


LD 

<N 

;RIGHT OF NOTE:- 

71 

E08 2 

CDC600 


CALL 

POSIT 


72 

E085 

3AA3E0 


LD 

A,(NOTE) 

;PRINT CURRENT 

73 

E08 8 

CDA200 


CALL 

CHPUT 

;NOTE, AND 

74 

E08B 

3AA4E0 


LD 

A,(NOTE+1) 

;PRINT + CHARACTER 


88 



/5 

E08E 

CDA200 


CALL 

CHPUT 

; OR SPACE 

lb 

E091 

1 8A1 


JR 

INPUT 

;GET NEXT KEY 

n 



t 




18 

E093 

22 

STRING: 

DB 

22H 

} START WITH QUOTES 

1 9 

E094 

4F3 4 

OCTVE: 

DB 

"04" 

;OCTAVE 4 

HO 

E096 

543630 

TEMPO: 

DB 

"T60 " 

;TEMPO 60 

111 

E099 

4C38 

DURAT: 

DB 

"L8" 

;DURATION 8 

112 

E09B 

5330 

ENVPAT: 

DB 

"SO" 

;ENV WAVEFORM SO 

113 

E09D 

4D313030 

ENVPER: 

DB 

"Ml 0000" 

;PERIOD Ml 0000 

H3 

E0A1 

3030 





114 



NOTE: 

DS 

2 

;NOTE STORAGE 

85 

E0A5 

22 


DB 

22H 

;PLAY END QUOTES 

lie 

E0A6 

00 


DB 

0 

; END STRING WITH 0 

H7 



? 




118 

E0A7 

444320 

TABLE: 

DB 

"D","C " 


119 

EOAA 

524323 


DB 

"r" , "c+" 


90 

EOAD 

464420 


DB 

"F","D " 


91 

EOBO 

544423 


DB 

"T","D+" 


92 

E0B3 

474520 


DB 

MqII "j? " 


93 

E0B6 

484620 


DB 

Hr" "p •• 


94 

E0B9 

554623 


DB 

"U","F +" 


95 

EOBC 

4A4720 


DB 



96 

EOBF 

494723 


DB 

"I","G+" 


97 

EOC2 

4B4120 


DB 

"k" , "a " 


98 

E0C5 

4F4123 


DB 

"0" , "A*" 


99 

E0C8 

4C4220 


DB 

"l'V'b " 


100 

EOCB 

OF 


DB 

OFH 

;END OF TABLE MARKER 

101 



i 




102 

EOCC 

43555252 

MESG1: 

DB 

"CURRENT NOTE " 


102 

EODO 

454E5420 





102 

E0D4 

4E4F5445 





102 

EOD8 

20 





103 

E0D9 

53544154 


DB 

"STATUS",0 


103 

EODD 

555300 





104 

EOEO 

4F435441 

MESG2: 

DB 

"OCTAVE:-",0 


104 

E0E4 

56453A2D 





104 

E0E8 

00 
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105 E0E9 4E4F5445 MESG3: DB "NOTE:-",0 

105 EOED 3A2DOO 

106 END 

Where practical the names, or labels, assigned to the ROM routines 
are as used in the MSX specification and should be compatible with 
other publications on MSX. They have a maximum length of 6 
characters and are usually an abbreviation of the function - CHGET 
is assigned to the routine which gets a character from the keyboard, 
Character GET . 

Analysis 

Line 13-CALL ERAFNK (00CCH) turns off the function key display. The 
sister routine is CALL DSPFNK (00CFH) which turns it back on. 

Line 15-CLIKSW (F3DBH) is the switch for the key press click. Here 
we zeroed A with XOR A and loaded zero into F3DB which turns it off, 
any other value switches it back on. 

Line 16-CALL CLS (00C3H) clears the screen but only if register A 
has been cleared by XOR A. 00C3H contains a jump to the actual CLS 
routine at 0848H, if you wish to clear the screen but aren't sure of 
the contents of A, a CALL 0849H will achieve the same goal by 
skipping the test on the flag. Used in the previous chapter. 

Line 19-CALL POSIT (OOC6H) positions the cursor depending on the 
value of HL. In lines 17/18 the column was entered into H and the 
line into L. 

Line 21-CALL PTMESG (6678H) as used previously, prints a message 
with the start address in HL and must terminate with a zero. MESG1 
is shown in line 102. 

Lines 22-31 The same as above. To aid readability H and L are loaded 
on separate lines and decimal values have been used, not hex. 




90 








Lines 27/28 could have been entered using only one line by 
converting the column and line values to hex (14 and 12 become OE 
and OC) so entering:- LD HL,0E0CH would make the program shorter. 

Line 33-CALL CHSNS (009CH) checks the keyboard buffer, where a 
pressed key is stored, and returns with Z flag reset if there was. 
It does not return with the character. If there was no key line 34 
is a relative jump back to line 33 to do it again. The program will 
not pass these 2 lines until a key is entered. 

Line 35-CALL CHGET (009FH) waits until a key is entered and returns 
with the ASCII value in register A. In fact we could have dispenced 
with lines 33/34 as this routine waits for a key but it also 
displays the cursor if it needs to do any waiting, and in my opinion 
spoilt the display, therefore using the CHSNS routine first means 
that the program does not reach here until a key is in the buffer 
and this routine picks up the key and does not need to wait thereby 
the cursor is not displayed. 

Line 36-checks if it was the '£' key and if so line 37 quits the 
program. This line jumps back to ZEN but if one saved this as a 
binary file and ran it without ZEN this instruction would be altered 
to RET Z. 

Lines 38/41- check for input of keys 1 to 8 to change the octave. 
Similar to the last chapter except that if the key is higher than an 
8 the program jumps to the SAMOCT label in line 49 to check on a 
note to be played. 

Line 42- is reached if the key was between 1 and 8 and loads the 
value into OCTVE+1, where the octave is stored. 

Lines 43/45 position the cursor next to the octave message on screen 
with a call to POSIT. 

Line 47-CALL CHPUT (00A2H) outputs the character in the A register, 
which was loaded in line 46, at the current cursor position already 
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specified in lines 43/45 and line 48 jumps back to INPUT for the 
next key. One could alter line 47 from CALL CHPUT to RST 18H which 
outputs register A to the current device, be it printer, screen or 
whatever. 

Line 49-CALL 0090H (GICINI) initialises the Programmable Sound 
Generator (PSG) and has been used to eliminate a queue of notes 
being stored and so not continuing to play for minutes after the key 
was released. Try deleting this line for different results. 

Line 51-LD HL,TABLE loads HL with the start address of the table of 
notes in line 88. The key entered has been stored in register B in 
line 50 and the first entry of the table is loaded into A in line 
52. Line 53 compares A with OFH as this defines the end of the 
table and if the key was not found it is assumed that an alien key, 
such as Z or X, was pressed and therefore nothing should be played 
and a jump back to INPUT is made for another key. 

Line 55 increments HL, moves it up a byte, and line 56 compares the 
key pressed (in B) with the table (in A) and if the two match a 
relative jump is made to FOUND to play the note (first time round it 
would be comparing with the first key in the table, key D). If the 
key did not match then HL must be moved up past the following bytes 
and must now point to the key 'R' in line 89, remembering it has 
been incremented once, so lines 58/59 incement HL twice more and 
line 60 jumps back to compare the next entry in the table. This 
comparing continues until HL is looking at the first byte in line 
100 (OFH) as this is where lines 53/54 checked for the end of the 
table, which OFH is, and aborted back to INPUT. 

Line 62-FOUND is reached when the key pressed matched a key in the 
table and a note must be played. Remember that HL is pointing to the 
table and has previously (line 55) been incremented. Assume the 'D' 
key was entered and HL will now be pointing to the byte after 'D' in 
line 88 of the table. This is the letter of the note to be played 
and therefore gets loaded into register A (line 62). Line 63 loads 
this note into position in the string, labelled NOTE in line 84. 





In fact 2 bytes have been reserved for this note in line 84 by 
entering it as 'DS 2'. The first is the letter of the note while 
the second byte is used to store the 1 +' sign. The first note in 
the table (line 88) is not followed by '+' and therefore a space is 
entered after the note - spaces are allowed in PLAY strings, 
although no action is taken - which will subsequently overwrite the 
previously stored note along with the ' + ' sign if it contained it. 
To load in the second part of the note line 64 increments HL, 
register A is either loaded with a space or '+' sign and line 66 
stores it into NOTE+1 which is the second byte of the storage. 

Line 68-CALL 73E5H calls the Basic routine for PLAY which requires 
the start of the string to be played to be in HL, which line 67 
achieves. 

Lines 69/71- position the cursor adjacent to the NOTE:- message on 
screen in order to display the note being played. 

Lines 72/75- load the note into A and print it with CALL CHPUT as 
used for the octave print in lines 43/47. As the note is always 2 
characters long register A is subsequently loaded with the second 
byte of the note storage and similarly gets displayed in line 75. 
The cursor does not require positioning for the second byte as it 
will have been automatically moved along one screen position after 
the previous CHPUT in line 73. This is then followed by JP INPUT to 
get the next key. 

Line 78- STRING is where the whole of the PLAY string is stored. 
Line 78 contains the ASCII value for "" which must open and close a 
play string. As we are accessing a Basic function it must appear 
syntactically correct else an error will be instituted and our 
machine code program will crash back into Basic, not a pleasant 
thought. Line 79 stores the octave and commences with the character 
0, not zero, and is followed by the starting value 4. This second 
byte obviously gets altered if one presses keys 1 to 8 whilst the 
program is running and so changes the octave. 
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Lines 80/83- set the remainder of the string for Tempo (T60), 
Duration (L8), Envelope waveform (SO zero this time, not 0) and 
Envelope Period (Ml 0000). These values remain constant, the only 
alterations via the keyboard are to the note and octave, although 
one can change them and re-assemble the program which takes seconds, 
for different results. One could also alter the program to accept 
the cursor keys for instance to alter tempo, duration or waveform. 

Line 84- contains the note storage which is blank when the program 
first runs. Line 85 is the ASCII value for the closing sign and 
line 86 contains a byte with a zero value which must be entered to 
signify the end of a string, just like the print strings. 

Lines 88/100 contain the table of keys followed by there respective 
notes and the line 100 contains the end of table marker 0FH. 

Lines 102/105- are the print strings which one should be familiar 
with by now, taking note of the trailing zero byte after each. 


To save as a binary file use the same procedure as in the last 

chapter. Alter line 37 to RET Z and note the last byte of the 

program when re-assembling to video and enter it when prompted as 
the STOP address. 

This program was written to run on screen 0 but is quite possible to 
run on screen 1 except the display will be slightly moved to the 
right, it will not upset the POSIT routine which positions the 
cursor. One could enter a line at the start of the code to 

initialise the screen:- 

CALL 006FH 

(INIT32) will initialise to screen 1. 

CALL 006CH 

(INITXT) initialises screen 0. 
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HOOKS 


The MSX allocates memory locations FD9A to FFC9 to what is known 
as a Hook area. There are 112 hooks each containing 5 bytes. 
Several routines within ROM make a call to these hooks to find if 
they contain additional instructions for tasks that should be 
performed. Normally they all contain the value C9 hex, which is the 
code for the RETurn instruction. Quite simply the routine in ROM 
calls the hook, finds it must return and do nothing, and carries on 
from where it left off. As sophisticated software becomes available 
for MSX these hooks will be used to hook up to disc drives and other 
peripheral devices in order to expand the system without the need to 
change the ROM. In order to write to a hook one must obviously know 
from which ROM routine it is called, so indiscriminant use could 
cause all sorts of problems, the rule should be, if you aren t sure 
leave it. 

The following program writes instructions into one such hook, at 
FD9F, labelled HTIMI. It is called from the timer interrupt handler 
routine, which means it is accessed 50 times a second whatever task 
the MSX is performing, excluding reading or writing to tape. This 
obviously lends itself to be used as a built in timer as one knows 
how many times a second it will be encountered. 

It has been used in the next program to slow down the movement of 
sprites, as without the delay they would move too quickly for the 
eye to see. Yes we could have written a machine code routine to 
create a delay, but that would not have demonstrated the use of a 
hook. 
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SPRITES 


The Video Display Processor (VDP) used in the MSX is extremely 
powerful and at first may appear rather complex to the average user, 
but then again so did Basic once upon a time. Your awareness of its 
capabilities will probably depend on the amount of information given 
in the manual supplied for your particular machine. In order to get 
the best from the VDP in the MSX one should at least be conversant 
with the Basic VDP system variable commands and how to access the 
various registers. This, unfortunately, cannot be described in one 
chapter and is beyond the scope of this introduction to machine 
code. For a fuller knowledge of its workings one would be well 
advised to obtain a book specifically written on the VDP of the MSX, 
one such book is titled 'Behind the Screens of the MSX' by Mike Shaw 
and should answer most if not all of ones questions. 

The main task of this next program is to set up 2 sprite patterns 
and move one across the screen until it collides with the other 
whereupon it will move up to the top of the screen. This program is 
only a demonstration of how to get sprites moving and detecting 
collisions, but with the machine coding practise you should have 
now, it could prove a good core program to fire-up the grey matter 
in order to get a complete display moving. One could try testing 
for the cursor keys being pressed and move the sprites accordingly, 
altering the shape and colours of the sprites etc. 

The explanations follow the assembled listing. 
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;TURN OFF FUNC KEYS 
;SCREEN 1 
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38 



; 




39 



;SET 

UP 

SPRITE 1 


40 

E023 

3E8C 



LD 

A,140 

41 

E025 

21001B 



LD 

HL,ATTR1 

42 

E028 

CD4D00 



CALL 

WRTVRM 

43 

E02B 

3EC8 



LD 

A,200 

44 

E02D 

21 01 IB 



LD 

HL,ATTR1+1 

45 

E0 3 0 

CD4D00 



CALL 

WRTVRM 

46 

E033 

3E41 



LD 

A,65 

47 

E0 35 

21021B 



LD 

HL,ATTR1 +2 

48 

E038 

CD4D00 



CALL 

WRTVRM 

49 

E03B 

3E01 



LD 

A,1 

50 

E0 3D 

21 031 B 



LD 

HL,ATTR1+3 

51 

E040 

CD4D00 



CALL 

WRTVRM 

52 



r 




53 



; SET 

UP 

SPRITE 2 


54 

E043 

3E8C 



LD 

A,140 

55 

E0 4 5 

21 0 41 B 



LD 

HL,ATTR2 

56 

E048 

CD4D00 



CALL 

WRTVRM 

57 

E04B 

3E1 E 



LD 

A,30 

58 

E04D 

21 051B 



LD 

HL,ATTR2+1 

59 

E050 

CD4D00 



CALL 

WRTVRM 

60 

E05 3 

3E42 



LD 

A, 6 6 

61 

E05 5 

21061B 



LD 

HL,ATTR2+2 

62 

E058 

CD4D00 



CALL 

WRTVRM 

63 

E05B 

3E0F 



LD 

A, 1 5 

64 

E05D 

21 071 B 



LD 

HL,ATTR2+3 

65 

E060 

CD4D00 



CALL 

WRTVRM 

66 



/ 




67 

E063 

AF 



XOR 

A 

68 

E06 4 

3298E0 



LD 

(COUNT),A 

69 



;DELAY COUNTER CHECK 

70 

E067 

CD9C00 

CKMOVE: 

CALL 

CHSNS 

71 

E06A 

2024 



JR 

NZ.QUIT 

72 

E06C 

3A98E0 



LD 

A, (COUNT) 

73 

E06F 

FE01 



CP 

1 

74 

E071 

3 8F4 



JR 

C,CKMOVE 


;VERTICAL POS 


;HORIZ POS 


;CHARACTER 65=A 


;COLOUR BLACK 


;VERTICAL POS 


;HORIZ POS 


;CHARACTER 66=B 


; COLOUR WHITE 


;ZERO COUNTER 


;IF LESS DONT MOVE 


98 





77 

E073 

21051B 


LD 

HL.ATTR2+1 

78 

E076 

CD4A00 


CALL 

RDVRM 

79 

E079 

3C 


INC 

A 

80 

E07A 

CD4DOO 


CALL 

WRTVRM 

81 

E07D 

AF 


XOR 

A 

82 

E07E 

3298E0 


LD 

(COUNT),A 

83 



;CHECK FOR 

COLLISION 

84 

E081 

3AE7F3 


LD 

A,(STATFL) 

85 

E084 

CB6F 


BIT 

5,A 

86 

E08 6 

2 8DF 


JR 

Z.CKMOVE 

87 



i 



88 



.•COLLISION 

OCCURED 

89 

E088 

21 041 B 


LD 

HL.ATTR2 

90 

E08B 

3E28 


LD 

A,40 

91 

E08D 

CD4D00 


CALL 

WRTVRM 

92 



J 



93 



;PROG END, 

SO REPLACE RET 

94 



; INTO HOOK 

(HTIMI) 

95 

E090 

3EC9 

QUIT: 

LD 

A.0C9H 

96 

E092 

329FFD 


LD 

(HTIMI),A 

97 

E09 5 

C303A0 


JP 

0A003H 

98 



, 



99 

E098 

00 

COUNT: 

DB 

0 

100 






101 



;INCREMENT 

COUNT 

50 TIMES A SEC 

1 02 

E099 

2198E0 

INCCNT: 

LD 

HL,COUNT 

103 

E09C 

34 


INC 

(HL) 

104 

E09D 

C9 


RET 


105 






106 

E09E 

C399E0 

CODE: 

JP 

INCCNT 

1 07 



. 
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END 



;VERT POS 
;PUT INTO A 
;MOVE 1 PIXEL RGHT 
;NEW POS OF SPRT 2 

;ZERO COUNTER 


;TEST COLLISION BIT 
;IF ZERO KEEP MOVING 


;HORIZ POS 

;MOVE IT UP 
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Lines 16/19 load code into the hook labelled HTIMI at FD9F. The 
LDIR instruction has been used which, as you should know by now, 
loads code from the address pointed to by HL into that pointed to by 
DE. The amount to transfer is held in BC, in this case 3 bytes 
which are shown in line 106 which tell the hook to jump to INCCNT 
which increments the counter. This has the effect of slowing the 
movement and can be speeded up or slowed as will be seen. 

Line 21 is the erase function key routine and this is followed by 
INIT32 which switches the display to screen 1, as you cannot have 
sprites on screen 0. 

Lines 26/29 Write to the VDP register whose number (0 to 7) must be 
in register C and the data to be loaded into the VDP held in 
register B. Here we are loading VDP register 6(C) with 0(B). This 
in effect is altering the base address of sprite pattern table to 
that of the character generator base address. So we now have the 
full ASCII character set stored as sprites. 

Line 33 Loads the value of RG1SAV (F3E0) which stores the current 
value of register 1 of the VDP. The only bit of VDP 1 we are 
interested in is bit 0 which controls the magnification for sprites. 
Zero is the normal size whilst altering it to 1 magnifies the 
sprites, so in line 34 we OR 1 which will not effect the remainder 
of the bits but will turn bit 0 to a 1, putting it in magnify mode. 
And once again we must load the contents of A into register B, 
select the VDP register in C and call WRTVDP, which will write to 
the VDP register 1. 

Now if that appeared slightly beyond you don't panic, as practise 
makes perfect, just enter the code and alter it later, it can only 
get easier and you will pick it up. 

Lines 40/51 set up sprite 1. The sprite attribute table in screen 1 
commences at address 1B00H and contains 4 bytes for each sprite. 
Therefore the attributes for sprite 2 will commence at 1B04H. These 
were given equates in lines 12/13, ATTRl and ATTR2. The first byte 
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holds the vertical pixel position of the sprite and line 40 loads 
register A with 140. The screen pixels are from 0 (top) to 191 
(bottom). Line 41 loads HL with the address of ATTRl (1B00H) and 
line 42 loads register A into VRAM at 1B00H by CALL WRTVRM. 

The process continues with loading the horizontal position into 
register A and storing it in the second byte of the attribute for 
sprite 1 at 1B01H by loading HL with ATTRl+1. 

note Line 47 could be entered as INC HL as when the program 
returns from the WRTVRM routine register HL is not changed in any 
way, therefore it still points to the previous location, and one 
could simply increment it. But it was shown in this form for 
clarity and not program elegance. 

The third byte of the attribute holds the sprite character number. 
But we have not defined our own sprite we have shifted the sprite 
pattern table so it is looking at the ASCII characters, purely for 
convenience. Therefore the ASCII for the letter A is 65 decimal, 
and line 46 loads register A with 65 as the letter A is to be our 
sprite 1. This is then loaded into the third byte in the 
attributes, ATTRl+2. Note that the although the decimal value was 
used for clarity, the assembler converted it to hex, as one will see 
in the left column. 

Lastly the colour must be defined and loaded into the fourth 
attribute byte ATTRl+3, and line 49 defines the colour number 1, 
which is black and this concludes the set up for sprite 1, having 
its co-ordinates, character and colour stored in 1B00 to 1B03H. 

The procedure is duplicated for setting up sprite 2 except the 
information must be stored at 1B04 to 1B07H, which was labelled as 
ATTR2 in line 13. The vertical position is the same as sprite 1, 
the only differences being the horizontal (30) in line 57, the 
character which this time is the letter B (ASCII 66 decimal) and the 
colour which is 15 for white. 
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Once the program is running these co-ordinates can be altered for 
different effects, providing one remembers to assemble each time. 

Lines 67/68 zero register A and loads this into COUNT. 

Lines 70/71 is the CHSNS routine which checks for a key being 
pressed and jumps to the QUIT routine, and has been included so that 
one can stop the program before it finishes to modify it just in 
case one has slowed it down too much. 

Line 72 loads the value stored in COUNT into register A and if it 
has not reached 1 line 74 jumps back to check it again. This loop 
continues until register A is equal or greater than the value in 
line 73. Remember the hook at FD9F is incrementing COUNT 50 times a 
second, therefore CP 1 will only cause the loop to continue for 
1/50th of a second before carrying on with the program and moving 
the sprite by 1 pixel. If line 73 was altered to CP 50 the sprite 
would move by 1 pixel only once a second, very slow. Without the 
delay at hook HTIMI the sprite would move so fast it would simply 
appear at the finishing point. 

Lines 77/82 move sprite 2 and zero the counter for the next delay 
before moving again. The only attribute we are changing is the 
horizontal position, ATTR2+1, therefore this must be loaded into HL 
and a call to read VRAM (RDVRM) will return the value in the A 
register (its current horizontal position). To move the sprite we 
INCrement A and write it back to the VRAM address still pointed to 
by HL by WRTVRM. 

Lines 84/86 check for a collision of the 2 sprites. STATFL (F3E7H) 
holds the status register of the VDP and bit 5 is set to 1 if a 
collision, 2 sprites overlap by at least 1 pixel, has occured. 
Therefore line 85 tests bit 5 of the status flag and line 86 jumps 
if it was zero back to CKMOVE again. If a collision had taken place 
bit 5 would be 1 therefore the zero flag would not be set and the 
test would fail and the program would fall through to the next line. 
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Line 90 is only reached after a collision and will shoot sprite 2 to 
near the top of the screen by loading HL by the vertical attribute 
ATTR2, leaving the horizontal ATTR2+1 intact, loading A with 40 and 
calling WRTVRM again to re-position it. 

Line 95 QUIT is reached after a collision or if a key has been 
pressed while the program was running. It simply replaces the 
contents of hook HTIMI with its original byte the code for RET 
(C9H), in case one is going to run another program as you will not 
want the hook accessing COUNT 50 times a second, and jumps back to 
ZEN. 


Line 99 is the storage byte for the counter. 

Lines 102/104 are accessed only from the hook HTIMI, and simply add 
1 to count each time the interrupt occurs. 

Once running experiment with altering the positions of the sprites 
and time delays and try adding a routine for moving each sprite on 
the press of certain keys. 
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LOADER PROGRAM 


When loading a machine code program one may have seen a different 
screen message displayed than the usual one or, as is becoming more 
popular, the complete display could alter to a graphics title while 
the program appears to be still loading. 

The answer can lie in the fact that two programs have been loaded, 
the second automatically. The first short program contains the 
titles and a jump to the loading routine for the second larger 
program. When the first program has loaded it executes immediately 
so printing the titles on screen and enters a loading routine for 
the second. Execution is so fast that the tape stops for a minimal 
time and starts again almost without being noticed. Only one 
1 Found:program name' message appears on screen whilst the first 
program is loading. 

The loader program begins with the screen title message, in the 
example it will display 'NOW LOADING MAIN PROGRAM', but this can be 
expanded upon as will be explained. It is advised to only add the 
loader jump section after fully debugging and testing the graphics 
titles. Although the ORG is set at 9000H, which is ideal for 
testing, before saving the object file it could be altered to 
another memory location, this also means that the second program 
could be set to the same ORG before saving and the loader program 
will be overwritten and dissappear from memory as the main program 
loads in. If one has recorded an ASCII file of one of the earlier 
programs it will be simple to test this loader. First complete the 
entries on the next page, making sure it runs correctly, then add in 
the loader section carefully and save as a binary file by the 'WB' 
command. Verify the tape and do not rewind as the main program will 
be recorded starting from where the first finished, on the next 
section of the tape. Kill the loader program from memory and load 
in a program from the earlier chapter Assemble and save the second 
program with the 'WB 1 command onto the tape, and one should possess 
two programs on the tape, the second will automatically load and 
run. 
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1 




ORG 

9000H 

2 




LOAD 

9000H 

3 



INIT32: 

EQU 

006FH 

4 



ERAFNK: 

EQU 

OOCCH 

5 



FORCLR: 

EQU 

0F3E9H 

6 



BAKCLR: 

EQU 

0F3EAH 

7 



BDRCLR: 

EQU 

0F3EBH 

8 



CHGCLR: 

EQU 

0062H 

9 



T32NAM: 

EQU 

1 80 OH 

1 0 



LDIRVM: 

EQU 

005CH 

1 1 



FILVRM: 

EQU 

0056H 

1 2 



1 



1 3 

9000 

CDCC00 


CALL 

ERAFNK 

1 4 

9003 

3E09 


LD 

A,9 

15 

9005 

32EAF3 


LD 

(BAKCLR),A 

1 6 

9008 

32EBF3 


LD 

(BDRCLR),A 

17 

900B 

3E01 


LD 

A, 1 

18 

900D 

32E9F3 


LD 

(FORCLR),A 

1 9 

901 0 

CD6F00 


CALL 

INIT32 

20 

9013 

210018 


LD 

HL,T32NAM 

21 

901 6 

3 EDI 


LD 

A, 0D1 H 

22 

9018 

010003 


LD 

BC,768 

23 

901 B 

CD5600 


CALL 

FILVRM 

24 

901 E 

212D90 


LD 

HL,DISPL 

25 

9021 

1 1 631 9 


LD 

DE,T32NAM+355 

26 

9024 

011AOO 


LD 

BC, 26 

27 

9027 

CD5C00 


CALL 

LDIRVM 

28 

902A 

C300A0 


JP 

0A000H 

29 



/ 



30 

902D 

204E6F77 

DISPL: 

DB 

" Now Loading" 

30 

9031 

204C6F61 




30 

9035 

64696E67 




31 

9039 

204D6169 


DB 

" Main Program 

31 

903D 

6E205072 




31 

9041 

6F677261 




31 

9045 

6D20 




32 




END 
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Analysis 


Line 13 which has been used before erases the function keys. 

Lines 14/18 set up the colours. Register A is first loaded with the 
code for the colour light red, and this is loaded into the storage 
bytes for background (BAKCLR) and border (BDRCLR) colours at F3EA 
and F3BE respectively. The character colours (FORCLR) is loaded 
with register A, this time 1 for black, at F3E9. 

Line 19 initialises screen 1 which will clear the screen and change 
it to the new colours. 

NOTE If one wished to simply alter the existing colours whilst 
remaining in the same screen mode and maintaining what was 
currently displayed on screen, a call to 0062H (CHGCLR) would 
suffice after setting up the colours. 

Line 20 loads HL with the start of the Name table for screen 1 
(1800H), the top left position. 

Line 21 loads register A with the code for the character which will 
cover the screen whilst line 22 loads our byte counter (register BC) 
with the number of positions we will write to. As screen 1 contains 
24 lines of 32 characters BC is loaded with 768 decimal, it could of 
course been converted to hex to read LD BC,300H. 

Line 23 calls a routine (FILVRM) at 0056H which writes the data in 
register A to VRAM, which has its source address in HL and the 
number of bytes in BC, all of which has been done. If one only 
wanted to write to the centre 4 lines of the screen then HL would 
instead have required loading with the start of the name table plus 
the offset. The tenth screen line starts at 288 positions (32x9 as 
first line is 0) higher than the start of the screen, therefore 
progam line 20 could have read:- LD HL,T32NAM+288. But obviously 
the byte counter would require reducing too, for 4 lines of print it 
should be loaded with 128 decimal (32x4). 
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Lines 24/26 load the start of our actual screen message ' Now 
Loading Main Program ' (labelled DISPL) into HL, load the 
destination address of its position into DE, and load the length of 
the message into BC (26 bytes including the leading and trailing 
spaces). As the message should commence 3 positions in from the left 
on line 12 the actual screen position is calculated thus:- 32x11+3, 
the top (first) line is 0 therefore to calculate the 12th line, the 
line width of 32 is multiplied by 11. 

Line 27 calls LDIRVM at 005CH which was used in chapter one to load 
VRAM directly with the contents of an area of RAM. 

Line 28 jumps back to the ZEN mainloop so the titles can be altered 
and run until it reaches your satisfaction. This jump address will 
be altered when we add the loading section. 

Aftering entering G9000H the display will switch into screen 1 mode 
and cover the screen with the ASCII character of D1 and the centre 
line will print our message. Get it running first and then make 
your alterations to colour, length of message etc., remembering to 
assemble after each change in the program otherwise the changes will 
not be entered into memory. After each test the 'ZEN message will 
appear at the top of the screen and in order to clear the screen and 
return to screen 0, which is the usual screen in ZEN, enter the 
'RETURN' key on its own. 

The Loader 

To append the loader routine make the line which contains the 
'END' message the current line, if one has not altered the program 
it should be line 32, and enter 'E' and 'Return' and add the lines 
listed on the following page. 
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TO 


DISPLAYED ENTER 


32 LOADER:LD A,OFEH 

33 LD (0F41CH),A 

34 LD HL,STRING 

35 JP 6EC6H 

36 STRING:DB 22H,"CAS:" 

37 DB 22H,2CH,"R",0 

38 

ZEN 


Line 28 which is the jump to Zen requires altering to:- 
JR LOADER 


this will then make the program jump to the loader routine after the 
titles have been displayed. Make sure the last line is still 'END' 
and assemble the program to (V)ideo and make a note of the last byte 
of the program. If one has not altered the program it should be 
905AH but obviously your program could be longer. The final section 
of the program would have assembled like this:- 


32 

9047 

3EFE 

LOADER: 

LD 

A,OFEH 

33 

9049 

321CF4 


LD 

(0F41CH),A 

34 

904C 

215290 


LD 

HL,STRING 

35 

904F 

C3C66E 


JP 

6EC6H 

36 

9052 

22434153 

STRING: 

DB 

2 2H,"CAS:" 

36 

9056 

3 A 




37 

9057 

222C5200 


DB 

22H,2CH,"R 

38 




END 



Quite simply we have loaded the value FE Hex into the contents of 
F41CH which stops a second 'Found:' message being printed when the 
second program is loading, which would spoil the display. Line 34 
loads HL with the start of a string which are the characters that 
could normally follow a BLOAD command i.e. "CAS:",R. We then jump 
to the BLOAD routine in ROM at 6EC6H. 
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To save the program as a binary file enter:- 
WB 

START 9000H 
STOP 905AH 
LOAD 9000H 
EXEC 9000H 

and give the loader the name of the main program that will follow it 
on tape. Afterwhich rewind the tape and verify by entering 'VB 1 and 
'RETURN 1 , and if all is well move the tape on slightly to allow a 
gap between the end of the loader and the start of the second 
program. 

Also, as a safety measure, save the ASCII file of this loader 
program on a separate tape for other programs and also in case it 
does not operate correctly when the second program is appended. 

Now kill the file by entering 'K' and 'RETURN 1 , similar to 'NEW' in 
Basic, and load in or enter from the keyboard the main program. If 
one saved the ASCII file of one of the earlier example programs in 
chapter 3 this will be ideal for testing. Alter the ORG and LOAD of 
the second program to 9000H, the same address as the loader used, 
and assemble to (V)ideo in order to note the last byte of the 
program and save as previously shown onto the same tape that 
contains the loader program, but press 'RETURN' when prompted for a 
name. 

To test switch off for a few seconds, and when turned back on 
enter:- 
BLOAD"CAS:",R 

and the first program found on the tape will load and run, 
displaying the titles, and in doing so should automatically load and 
run the second, main program. 


109 


Argument Transfer using USR 


The USR function was used in chapter 1 with what is termed as a 
dummy argument within the brackets i.e. USR(O). It is possible to 
pass up to a machine code routine an integer, string, single or 
double precision variable. A=USR(SHI 234) would store in a storage 
area in RAM the hex value 1234 and call up the machine code routine. 
Misuse of this function could cause a program to crash. 

The type of argument passed to the routine is always stored at 

address F663, so the routine can check what type has been passed up, 

and would contain:- 

2 for an integer 

3 a string 

4 a single precision real type variable 
8 a double precision real type variable. 

Take an example:- 

First one needs to DEFine the USeR address as was shown in chapter 1 
(i.e. 10 DEF USR2=SHE000). Our machine code routine is called from 
Basic to execute a certain task, it could be to move a block of 

memory, and requires the destination address (for example A020H) to 

be passed from the Basic program and stored in order to load into 
register DE. The Basic line could be:- 
100 A=USR2(&HA020) 

This would then call the machine code routine at address EOOOH and 
carry out any tasks until it RETurned to the Basic program. The 
integer (or address) A020H is always stored at address F7F8 and F7F9 
hex. Therefore to load the integer into register DE all the machine 
code program needs to do is:- 
LD DE,(0F7F8H) 

and DE will contain A020H. If, while still in the machine code 
routine, one wished to alter the integer and pass it back down to 
the Basic program when it RETurns simply:- 
LD (F7F8H),DE 

and the new value will be placed into variable A on returning to the 
Basic program. 
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Strings operate in a slightly different manner in that F7F8 and F7F9 
hex will contain NOT the string, but an address where the string 
descriptor is located. This string descriptor contains 3 bytes. 
The first signifies the string's length and the second and third the 
address where it is stored, and could be used thus:- 

100 B$="MSX" 

110 A$=USR2(B$) 

This time, as it is a string, F663H contains the value 3. Addresses 
F7F8 and F7F9 hex contain the address of the descriptor, for example 
802D, and at address 802D will be the length of the string, 3, while 
802E and 802F will contain the actual location where the string is 
stored in reverse order naturally. Did I mention it was complicated? 

Single precision values, type 4, are stored at F7F6 to F7F9 hex and 
Double precision, type 8, at F7F6 to F7FD hex. 

WARNING One cannot access the storage addresses (F7F6H onwards) 
after the routine has returned to the Basic program (they cannot be 
PEEKed), as they will not be stored. Only the variable which was 
used in the USR line (in the last example A$) will contain the data. 

For an example of how an integer would be passed into a machine code 
routine load ZEN in the normal way, and enter this short program:- 

1 ORG 0E000H 

2 LOAD 0E000H 

3 LOOP:EQU 0A003H 

4 LD DE,(0F7F8H) 

5 JP LOOP 

6 END 

7 . 


and assemble. 


Ill 


If all is well enter 'B' to return to Basic and enter this Basic 
program:- 

10 DEFUSR2=&HA000 
20 A=USR2(«H1234) 

30 PRINT HEX$(A) 
and RUN. 

The program will enter the ZEN mainloop so enter:- 

GE000H and 'RETURN' twice. The short program will execute 
immediately and return with the ZEN prompt. Now enter 'X' to 
examine the registers and one will find DE contains 1234, which 
proves that an integer can be passed up to a routine. 

To discover how it passes back an integer enter 'MF7F8H' and the 
contents will be displayed as 34. Enter 35H and 'RETURN' followed 
by the full stop '.' and 'RETURN' which alters the contents of 
memory, as you will obviously know by now. Enter 'B' to return to 
Basic and line 30 will then execute and print the hex value of 
variable A, which one will see has changed to 1235H. 

The 'Q' command in ZEN is useful for displaying the contents of 
memory and could be used here to discover how the single and double 
precision variables are stored, as once control is passed back to 
Basic the storage area is corrupted. 
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This section lists some of the useful routines found in ROM which 
can be used by your own machine code program, some have been used 
already in previous chapters, and some may be too advanced for ones 
immediate use. 

The start of ROM contains a table of jumps to the various routines, 
some of the more straightforward have been listed to assist if one 
wishes to disassemble certain sections of memory, but normally a 
call to the appropriate location in the table is all that will be 
required, providing one knows which registers should be loaded with 
the relevant data before the call is made. Each routine carries an 
abbreviated name, or label up to six characters in length, as used 
in the MSX specification. 


Addr Jump Name Function 

0000 02D7 CHKRAM The first byte disables the interrupts and a jump 
to 02D7 checks RAM and sets slots for the command 
area, this is followed by the address of the 
character generator table and also the ports for 
VDP read and write. 

0008 2683 SYNCHR Called by RST 8. Checks the current character 
pointed to by HL is the required one and falls 
into CHRGTR if true, else gives Syntax error. 
Character to be checked must be the next byte 
after this RST. Carry flag set if it is a number, 
Z flag set if end of statement. 

Modifies AF,HL 


0010 2686 CHRGTR Gets next character, or basic token, in basic 
text. Entry HL. Exits with HL pointing to next 
char, A contains char, carry flag set if number, Z 
flag set if end of statement. 

Modifies AF,HL 
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Addr Jump Name Function 

0018 1B45 OUTDO Outputs contents of reg A to current device, VDU, 
printer etc. Called by RST 18H 

0020 146A DCOMPR Compares HL with DE and sets Zero flag if matched. 
Modifies AF 

0038 0C3C KEYINT Performs hardware interrupt procedure 50 times a 
second. 

Modifies nothing. 

0041 0577 DISSCR Disables screen, blanks out screen. 

Modifies AF, BC 

0044 0570 ENASCR Enables screen, switches it back and restores 
characters which were previously displayed. 
Modifies AF, BC 

0047 057F WRTVDP Writes data to VDP register. Enter with reg in C, 
data in B 
Modifies AF, BC 

004A 07D7 RDVRM Reads VRAM pointed to by HL, returns data in reg 

A. 

Modifies AF 

004D 07CD WRTVRM Writes to VRAM pointed by HL, data in reg A. 
Modifies AF 

0050 07EC SETRD Sets up VDP for Read. HL on entry. 

Modifies AF 

0053 07DF SETWRT Sets up VDP for Write. HL on entry. 

Modifies AF 

0056 0815 FILVRM Fills VRAM starting at HL with data in reg A and 
length in BC. 

Modifies AF, BC 
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Addr Jump Name Function 

0059 070F LDIRMV Moves block of VRAM to memory. VRAM source in HL 
to destination in DE and length in BC. 

Modifies all. 

005C 0744 LDIRVM Moves block of memory to VRAM from source in HL to 
VRAM destination in DE and length in BC. 

Modifies all. 

005F 084F CHGMOD Initialises screen according to value of reg A, 0 
to 3. Stores A at FCAFH. 

Modifies all. 

0062 07F7 CHGCLR Changes colour of screen to colours specified in:- 
Foreground colour (FORCLR) at F3E9, Background 
(BAKCLR) at F3EA and Border (BDRCLR) at F3EB. 
Modifies all. 

0066 1398 NMI Performs non-maskable Interrupt procedure. Entry 

none. 

Modifies none. 

0069 06A8 CLRSPR Initialises all sprites. Patterns are set to 
nulls. 

006C 050E INI TXT Initialises screen to text mode, screen 0 and sets 
VDP. 

Modifies all. 

006F 0538 INIT32 Initialises for screen 1, and sets VDP. 

Modifies all. 

0072 05D2 INIGRP Initialises to screen 2, and sets VDP. 

Modifies all. 

0075 061F INIMLT Initialises to screen 3, and sets VDP. 

Modifies all. 
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Addr Jump Name Function 

0078 0594 SETTXT Sets VDP for screen 0 

007B 05B4 SETT32 Sets VDP for screen 1 

007E 0602 SETGRP Sets VDP for screen 2 

0081 0659 SETMLT Sets VDP for screen 3 

0084 06E4 CALPAT Returns address of sprite pattern table in HL. 
Entry reg A = sprite no. 

Modifies AF, DE, HL. 

0087 06F9 CALATR Returns address of sprite attribute table in HL. 
Entry sprite no. in reg A. 

Modifies AF, DE, HL. 

008A 0704 GSPSIZ Returns current sprite size in reg A (no. of 
bytes) Returns carry flag set if 16x16 sprite 
otherwise reset. 

Modifies AF. 

008D 1510 GRPPRT Prints a character on graphic screen in reg A. 

0090 04BD GICINI Initialises PSG. 

Modifies all. 

0093 1102 WRTPSG Write data in reg E to PSG register number in A. 

0096 110E RDPSG Reads data from PSG register in A, returns with 

data in A. 

Modifies AF. 

0099 11C4 STRTMS Checks and starts the background music. 

009C 0D6A CHSNS Checks the keyboard for pressed key. Returns with 

Z flag set if key in buffer. 

Modifies AF. 
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Addr Jump Name 


Function 


009F 10CB CHGET 

00A2 08BC CHPUT 

00A5 085D LPTOUT 

OOA8 0884 LPTSTT 


OOAE 23BF PINLIN 


00B7 046F BREAKX 

00C0 1113 BEEP 

00C3 0848 CLS 

00C6 088E POSIT 

00C9 0B26 FNKSB 

00CC OBI 5 ERAFNK 


Waits until a key is typed. Returns with ASCII of 
key in reg A. 

Modifies AF. 

Outputs contents of reg A to screen. 

Outputs contents of reg A to printer. Carry flag 
set if aborted. 

Modifies F. 

Checks printer status. Returns FFhex in A and Z 
flag reset if printer ready, 0 in A and Z flag set 
if not ready. 

Modifies AF. 

Stores line of input from keyboard in buffer, 
terminates when RETURN entered. Returns start of 
buffer in HL, carry flag set if STOP was entered. 
Modifies all. 

Checks for CTRL/STOP keys. Carry flag set if 
pressed. 

Modifies AF. 

Sounds bell. 

Clears screen if Z flag set. 

Positions the cursor. Entry H=column, L=line. 
Modifies AF. 

Checks if function keys should be on, if so 
displays them, else does nothing. 

Modifies all. 

Turns off function key display. 

Modifies all. 
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Addr Jump Name Function 

OOCF 0B2B DSPFNK Turns on function key display. 

Modifies all. 

00D2 083B TOTEXT Forces screen into text mode. 

Modifies all. 

0132 0F3D CHGCAP Switches CAPS light on/off, but does not affect 
CAP status. Entry 0 in reg A turns on, any other 
turns off. 

Modifies AF. 

0156 0468 KILBUF Clears keyboard buffer. 

Modifies HL. 

Addresses F380H upwards are assigned to storage areas for 
accessing from ROM or equally from your own program in RAM. The 
more common of which are listed below followed by their MSX name and 
amount of bytes and purpose. 

For example the current line length of screen 0 is held at F3AEH, 
and is usually set to 25H (37 dec) and can naturally be altered as 
this is in RAM. To check on the contents of a location in memory 
one could enter a Basic line:- ?PEEK(&HF3AE) or from ZEN :-QF3AEH. 

Addr Name Size Function 

F39A USRTAB 20 Addresses assigned to the 10 USR functions (0 to9). 

Until a DEF USR statement been initialised these 
addresses all contain 475A which loads error 5 into 
the error flag. 

F3AE LINL40 1 Line width in screen 0 

F3AF LINL32 1 Line width in screen 1 
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Addr 


Name Size Function 


F3B0 LINLEN 1 

F3B2 CLMLST 1 

F3B3 TXTNAM 2 

F3B5 TXTCOL 2 

F3B7 TXTCGP 2 

F3B9 TXTATR 2 

F3BB TXTPAT 2 

F3BD T32NAM 2 

F3BF T32COL 2 

F3C1 T32CGP 2 

F3C3 T32ATR 2 

F3C5 T32PAT 2 

F3C7 GRPNAM 2 

F3C9 GRPCOL 2 

F3CB GRPCGP 2 

F3CD GRPATR 2 

F3CF GRPPAT 2 


Line length. 

Lines on screen. 

Screen 0 

Name address table start. (0000H) 

Colour " " " (unused) 

Character Generator table start (0800H) 
Attribute Table start (unused) 

Sprite Pattern Generator table start (unused) 
Screen 1 

Name address table start. (1800H) 

Colour " " " (2000H) 

Character Generator table start (0000H) 

Attribute Table start (1B00H) 

Sprite Pattern Generator table start (3800H) 
Screen 2 

Name address table start. (1800H) 

Colour " " " (2000H) 

Character Generator table start (0000H) 

Attribute Table start (1B00H) 

Sprite Pattern Generator table start (3800H) 
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Addr Name Size Function 


F3D1 MLTNAM 

F3D3 MLTCOL 

F3D5 MLTCGP 

F3D7 MLTATR 

F3D9 MLTPAT 

F3DB CLIKSW 

F3DC CSRY 

F3DD CSRX 

F3DE CNSDFG 

F3DF to 
F3E6 

F3E7 STATFL 

F3E9 FORCLR 

F3EA BAKCLR 

F3EB BDRCLR 

F55E BUF 

F672 MEMSIZ 


Screen 3 

2 Name address table start. (0800H) 

2 Colour " " " (unused) 

2 Character Generator table start (0000H) 

2 Attribute Table start (1B00H) 

2 Sprite Pattern Generator table start (3800H) 

1 Key click switch. 0=off, any other=on 

1 Cursor Y position (line) 

1 Cursor X position (column) 

1 Function key display switch. 0=off 

VDP Register values 
8 Stores VDP 0 to VDP 7 

1 Stores VDP Status register 
1 Foreground colour 
1 Background colour 

1 Border colour 

256 Input Buffer 

2 Highest location in memory 
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5 

Bytesearcher 


This utility program is loaded from ZEN and simply appends a byte 
search routine which is useful when disassembling sections of 
memory. One can either search for a two byte address or string. 

Two byte search 

The keyboard routine within ZEN commences at address A742H, and let 
us suppose one wanted to discover where and how often the keyboard 
routine was referred to within the memory area which ZEN occupies. 
One would enter:- 
YA742H 

Note that the address is entered correctly, not as it would be found 
in memory low byte first, as the search routine adjusts for this. 
The command 'Y 1 has been used as most other letters are already 
utilised, although this could be altered in line 11 to a lower case 
(small) letter such as 's' which is not otherwise used. 

One will be prompted to enter the 'START' address followed by 'H', 
so if ZEN was to be searched enter the first memory location of 
ZEN: - 
AOOOH 

Logically the next prompt is for 'END', so in this example one could 

enter the last address of ZEN:- 

BB5CH 

The final prompt is for 'OPTION' and for the screen to display the 
locations one would enter 'V'. The screen will then display:- 

Occurences of A742H 
between:-A000 and BB5C 

A7F4 A92A 
ZEN 
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String search 


Strings may be searched for by entering the string within quotes:- 
Y"Ok" 


which will search for the 'Ok' message. To 
the ROM one would enter the Start address 
and for the End address enter the top of 
would then display:- 


find its location within 
as '0000' or simply 'O', 
ROM '8000H'. The screen 


Occurences of "Ok" 
between:-0000 and 8000 


3FD7 

ZEN 


which is the location in ROM where this message resides. 

The two byte search could then be used to discover which areas of 
the ROM access the 'Ok' message by searching for 3FD7 between 0 and 
8000H, and the display would reveal that it is referred to at:- 
412F 53FB and 7072 

Bytesearcher accesses many routines within ZEN only once calling a 
routine outside at 0020H which is a ROM routine to compare HL with 
DE, and the routines are listed in the comment field and may be 
checked against your ZEN reference manual. 

The program can be saved as an ASCII file, where one simply enters 
'W' and enters the filename, and can be loaded back in and assembled 
only when one requires the extra byte search facility, for 
disassembling. 

NOTE After entering the code, or loading from tape, it is 
essential to assemble the bytesearcher BEFORE modifying the 3 
bytes at A251H, as this area is within the mainloop of ZEN and a 
jump is made to E000H to discover if the key pressed was 'Y', and 
if it has not been assembled the bytesearcher program will not be 
at E000H and ZEN could crash and the program lost. 
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;BYTESEARCHER 
;AFTER ASSEMBLY ALTER 
JZEN BY:- M0A251H 
;and enter these 3 bytes 
;0C3H 00 0E0H 
7 

ORG 0E000H 
LOAD 0E000H 


I 


10 EO00 CAA5A3 
1 1 E003 FE59 
12 E005 2803 
1 3 
1 4 

15 

16 E007 C354A2 
1 7 

18 EOOA 118AA1 

19 EOOD 21D6E0 

20 EO10 010000 

21 
22 

23 

24 E013 1 A 

25 E014 77 

26 E015 23 

27 EO16 13 

28 EO17 03 

29 E018 FEOD 

30 E01A 20F7 

31 

32 

33 

34 

35 E01C 78 

36 E01D OD 

37 E01E B1 


:XTRA: JP Z,0A3A5H 

CP "Y" 

JR Z,BYTSCH 

New commands go here 


Transfer complete-Check that 
something is there 


;Orig routine 
;For Bytesearcher 
;It's what we want 


JP 

0A254H 

jBack to Zen 

LD 

DE,0A18AH 

;(TBUFF+1) 

LD 

HL,SCHSTR 

;Store Input 

LD 

BC, 0 

jString counter 

ie string 


LD 

A,(DE) 


LD 

(HL) ,A 


INC 

HL 


INC 

DE 


INC 

BC 


CP 

0DH 

;Return? 

JR 

NZ,TRSTR 

;No-keep transfi 


;Don't count 'CR' 







38 

E01F 

CAD5A8 

JP 

Z,0A8D5H 

39 



f 


40 



;Now get START/STOP parameter 

41 



/ 


42 

E022 

CDC5A8 

CALL 

0A8C5H 

43 

E025 

2B 

DEC 

HL 

44 

E026 

19 

ADD 

HL, DE 

45 

E027 

ED532CA1 

LD 

(0A12CH),DE 

46 

E02B 

222EA1 

LD 

(0A12EH),HL 

47 

E02E 

CD39AB 

CALL 

0AB39H 

48 



r 


49 



;Print title 


50 



? 


51 

E031 

21E0E0 

LD 

HL,MSG1 

52 

E034 

CDDCA7 

CALL 

0A7DCH 

53 

E037 

21D6E0 

LD 

HL,SCHSTR 

54 

E03A 

CDDCA7 

CALL 

0A7DCH 

55 

E03D 

21EFEO 

LD 

HL,MSG2 

56 

E040 

CDC4A6 

CALL 

0A6C4H 

57 

E0 43 

CDDCA7 

CALL 

0A7DCH 

58 

E046 

2A2CA1 

LD 

HL,(0A12CH) 

59 

E0 49 

CD95A9 

CALL 

0A995H 

60 

E04C 

21F9E0 

LD 

HL,MSG3 

61 

E04F 

CDDCA7 

CALL 

0A7DCH 

62 

E052 

2A2EA1 

LD 

HL,(0A12EH) 

63 

E055 

CD95A9 

CALL 

0A995H 

64 

E058 

CDC4A6 

CALL 

0A6C4H 

65 

E05B 

CDC4A6 

CALL 

0A6C4H 

66 



i 


67 



;Check for H or 

Quote at end 

68 



r 


69 

E05E 

21D6E0 

LD 

HL,SCHSTR 

70 

E061 

0600 

LD 

B, 0 

71 

E06 3 

7E 

FENDS: LD 

A, (HL) 

72 

E064 

FE0D 

CP 

0DH 

73 

E066 

2804 

JR 

Z,COMP 

74 

E068 

23 

INC 

HL 


;Error, so 'HUH?' 


;'STARTSTOP' 


;=START 
;=STOP 


;ZEN "STR1" 


;Start of Data 
; ZEN "WORDSP" 


;End of Data 

;ZEN "CRLF" 

;another CRLF 


;Counter for convert 
;Find string end 
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IH?' 

’5 

E069 

04 


INC 

B 


'6 

E06A 

1 8F7 


JR 

FENDS 


’7 



/ 




'8 

E06C 

2B 

COMP: 

DEC 

HL 


>9 

E06D 

7E 


LD 

A , ( HL) 


10 

E06E 

FE22 


CP 

22H 


11 

E070 

281 6 


JR 

Z , SEEK 


12 

E072 

FE48 


CP 

"H" 


13 

E074 

C2D5A8 


JP 

NZ , 0A8D5H 


14 

E077 

23 


INC 

HL 


5 

E078 

11D6E0 


LD 

DE,SCHSTR 


6 

E07B 

CDDAA8 


CALL 

0A8DAH 


7 

E07E 

22D7E0 


LD 

(SCHSTR+1 ) , HL 


8 

E081 

3E0D 


LD 

A, 0DH 


9 

E08 3 

32D9E0 


LD 

(SCHSTR + 3) , A 


0 

1 

E086 

1 802 


JR 

FIND 


2 

E088 

360D 

! 

SEEK: 

LD 

(HL) , 0DH 


3 

E08A 

2A2CA1 

FIND: 

LD 

HL,(0A1 2CH) 


4 

E08D 

ED5B2EA1 


LD 

DE,(0A12EH) 


5 

E091 

2B 


DEC 

HL 


6 

E092 

D5 


PUSH 

DE 


7 

E093 

E5 


PUSH 

HL 


8 



/ 




9 

E09 4 

AF 


XOR 

A 


0 



/ 




1 

E095 

32D5E0 


LD 

(COUNT),A 


2 

E098 

El 

FINDIT: 

POP 

HL 


3 

E099 

D1 


POP 

DE 


4 

E09A 

23 


INC 

HL 


5 

E09B 

D5 


PUSH 

DE 


6 

E09C 

E5 


PUSH 

HL 

onvert 

7 

E09D 

CD2000 


CALL 

0020H 

nd 

18 

E0A0 

2008 


JR 

NZ,LOOK 


'9 

E0A2 

El 


POP 

HL 


0 

E0A3 

D1 


POP 

DE 


1 

E0A4 

CDC4A6 


CALL 

0A6C4H 


;Back-up to 'H' or " 
;It's a quote string 


;Not hex 
;Back to end 

;ZEN convert routine 


;ROM Compare HL'DE 


;Finished so CRLF 
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75 

E069 

04 

INC 

B 



76 

E06A 

1 8F7 

JR 

FENDS 



77 



r 




78 

E06C 

2B 

COMP: DEC 

HL 

;Back-up to 

'H' or " 

79 

E06D 

7E 

LD 

A, (HL) 



80 

E06E 

FE22 

CP 

22H 

;It's a quote string 

81 

E0 70 

281 6 

JR 

Z , SEEK 



82 

E072 

FE48 

CP 

"H" 



83 

E074 

C2D5A8 

JP 

NZ , 0A8D5H 

;Not hex 


84 

E077 

23 

INC 

HL 

;Back to end 


85 

E078 

11D6E0 

LD 

DE,SCHSTR 



86 

E07B 

CDDAA8 

CALL 

0A8DAH 

;ZEN convert 

routine 

87 

E07E 

22D7E0 

LD 

(SCHSTR+1 ) , HL 



88 

E081 

3E0D 

LD 

A, 0DH 



89 

E08 3 

32D9E0 

LD 

(SCHSTR+3),A 



90 

E086 

1 802 

JR 

FIND 



91 



! 




92 

E088 

360D 

SEEK: LD 

(HL),0DH 



93 

E08A 

2A2CA1 

FIND: LD 

HL,(0A12CH) 



94 

E08D 

ED5B2EA1 

LD 

DE,(0A12EH) 



95 

E091 

2B 

DEC 

HL 



96 

E092 

D5 

PUSH 

DE 



97 

E093 

E5 

PUSH 

HL 



98 



r 




99 

E094 

AF 

XOR 

A 



100 



t 




101 

E09 5 

32D5E0 

LD 

(COUNT),A 



102 

E098 

El 

FINDIT: POP 

HL 



103 

E099 

D1 

POP 

DE 



104 

E09A 

23 

INC 

HL 



105 

E09B 

D5 

PUSH 

DE 



106 

E09C 

E5 

PUSH 

HL 



107 

E09D 

CD2000 

CALL 

0020H 

;ROM Compare 

HL 1 DE 

1 08 

EOAO 

2008 

JR 

NZ,LOOK 



109 

E0A2 

El 

POP 

HL 



11 0 

E0A3 

D1 

POP 

DE 



11 1 

E0A4 

CDC4A6 

CALL 

0A6C4H 

;Finished so 

CRLF 
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1 1 2 

E0A7 

C300A0 


JP 

0A000H 

;Back to 

ZEI 

1 1 3 



t 





11 4 

EOAA 

11D7E0 

LOOK: 

LD 

DE,SCHSTR+1 



1 1 5 

EOAD 

1A 

LOOKIT: 

LD 

A,(DE) 



11 6 

EOAE 

FEOD 


CP 

ODH 



11 7 

EOBO 

2807 


JR 

Z,FOUND 



11 8 

E0B2 

BE 


CP 

(HL) 



11 9 

E0B3 

2 0E3 


JR 

NZ ,FINDIT 



1 20 

E0B5 

13 


INC 

DE 



121 

E0B6 

23 


INC 

HL 



122 

E0B7 

1 8F4 


JR 

LOOKIT 



1 23 



f 





1 24 

E0B9 

El 

FOUND: 

POP 

HL 

; Address 

th 

125 

EOBA 

E5 


PUSH 

HL 

;Restack 

it 

126 

EOBB 

CD95A9 


CALL 

0A995H 



1 27 

EOBE 

3AD5E0 


LD 

A, (COUNT) 



1 28 

E0C1 

3C 


INC 

A 



1 29 

E0C2 

FE05 


CP 

5 
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E0C4 

32D5E0 


LD 

(COUNT),A 



1 31 

E0C7 

20CF 


JR 

NZ,FINDIT 



1 32 

E0C9 

AF 


XOR 

A 
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EOCA 

32D5E0 


LD 

(COUNT),A 



134 

EOCD 

CDC4A6 


CALL 

0A6C4H 



1 35 

EODO 

1 8C6 


JR 

FINDIT 



1 36 



i 





1 37 

E0D2 

C300A0 


JP 

0A000H 



1 38 

E0D5 

00 

COUNT: 

DB 

0 



1 39 



SCHSTR: 

DS 

10 
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EOEO 

4F636375 

MSG1 : 

DB 

"Occurences of " 

, ODH 


1 40 

E0E4 

72656E63 






1 40 

E0E8 

6573206F 






1 40 

EOEC 

66200D 
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EOEF 

62657477 

MSG2: 

DB 

"between:,ODH 



1 41 

EOF 3 

65656E3A 






141 

E0F7 

2D0D 






1 42 

E0F9 

616E6420 

MSG3 : 

DB 

"and ",ODH 



1 42 

EOFD 

OD 






1 43 




END 
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Appendix 


HEX to OPCODE Conversion Table 


This first table is to assist when one knows the Hex value and 
wishes to know the opcode and the amount of bytes it should be 
followed by. When one attempts to convert decimal values in Basic 
DATA statements to Opcodes and Operands be sure to start with the 
first byte in the routine, else one could get false information. 

As an example take program 1 in chapter 1. The first byte in the 
DATA line has the decimal value of 62, convert this to hex and one 
will see it is 3Ehex. Now look in the table below to find what 3E 
signifies. It is LD A,nn which means load register A with the value 
of the next byte which is 66 dec (42hex). Now continue with the 
third value in the DATA line which is 33 which converts to 21 hex. On 
checking below one will see it signifies LD HL,aabb and must have 
the next two bytes loaded into HL and so on. If one began converting 
at the wrong place, say at the second byte, and tried to convert 66 
to hex (42) and then looked in the table below it equals on its own 
LD B,D which would be totally wrong, therefore it is essential to 
start at the beginning. 

In the table nn equals a one byte value in the range OOh to FFh (0 
to 255 dec) and bb aa two bytes in the same range. 


00 

NOP 

OC 

INC C 

01 bb aa 

LD BC,aabb 

0D 

DEC C 

02 

LD (BC),A 

0E nn 

LD C,nn 

03 

INC BC 

OF 

RRCA 

04 

INC B 

1 0 nn 

DJNZ nn 

05 

DEC B 

11 bb aa 

LD DE,aabb 

06 nn 

LD B,nn 

12 

LD (DE),A 

07 

RLCA 

1 3 

INC DE 

08 

EX AF,AF' 

1 4 

INC D 

09 

ADD HL,BC 

1 5 

DEC D 

0A 

LD A,(BC) 

1 6 nn 

LD D,nn 

0B 

DEC BC 

1 7 

RLA 
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18 nn 


JR nn 

19 


ADD HL,DE 

1 A 


LD A,(DE) 

IB 


DEC DE 

1C 


INC E 

ID 


DEC E 

1 E nn 


LD E,nn 

IF 


RRA 

20 nn 


JR NZ,nn 

21 bb 

aa 

LD HL,aabb 

22 bb 

aa 

LD (aabb),HL 

23 


INC HL 

24 


INC H 

25 


DEC H 

26 nn 


LD H,nn 

27 


DAA 

28 nn 


JR Z,nn 

29 


ADD HL,HL 

2A bb 

aa 

LD HL,(nn) 

2B 


DEC HL 

2C 


INC L 

2D 


DEC L 

2E nn 


LD L,nn 

2F 


CPL 

30 nn 


JR NC,nn 

31 bb 

aa 

LD SP,aabb 

32 bb 

aa 

LD (aabb),A 

33 


INC SP 

34 


INC (HL) 

35 


DEC (HL) 

36 nn 


LD (HL),nn 

37 


SCF 

38 nn 


JR C,nn 

39 


ADD HL,SP 

3A bb 

aa 

LD A,(aabb) 

3B 


DEC SP 

3C 


INC A 


3D 

DEC A 

3E nn 

LD A,nn 

3F 

CCF 

40 

LD B, B 

41 

LD B,C 

42 

LD B,D 

43 

LD B, E 

44 

LD B,H 

45 

LD B,Ln 

46 

LD B,(HL) 

47 

LD B,A 

48 

LD C,B 

49 

LD C,C 

4A 

LD C,D 

4B 

LD C,E 

4C 

LD C,H 

4D 

LD C,L 

4E 

LD C,(HL) 

4F 

LD C,A 

50 

LD D,B 

51 

LD D,C 

52 

LD D,D 

53 

LD D,E 

54 

LD D,H 

55 

LD D,L 

56 

LD D,(HL) 

57 

LD D,A 

58 

LD E,B 

59 

LD E,C 

5A 

LD E,D 

5B 

LD E,E 

5C 

LD E,H 

5D 

LD E,L 

5E 

LD E,(HL) 

5F 

LD E, A 

60 

LD H,B 

61 

LD H,C 
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62 

LD H, D 

85 

ADD A,L 

63 

LD H,E 

86 

ADD A,(HL) 

64 

LD H, H 

87 

ADD A,A 

65 

LD H,L 

88 

ADC A, B 

66 

LD H,(HL) 

89 

ADC A,C 

67 

LD H,A 

8A 

ADC A, D 

68 

LD L,B 

8B 

ADC A,E 

69 

LD L,C 

8C 

ADC A, H 

6A 

LD L,D 

8D 

ADC A,L 

6B 

LD L,E 

8E 

ADC A,(HL) 

6C 

LD L,H 

8F 

ADC A,A 

6D 

LD L,L 

90 

SUB B 

6E 

LD L,(HL) 

91 

SUB C 

6F 

LD L, A 

92 

SUB D 

70 

LD (HL),B 

93 

SUB E 

71 

LD (HL),C 

94 

SUB H 

72 

LD (HL),D 

95 

SUB L 

73 

LD (HL),E 

96 

SUB (HL) 

74 

LD (HL),H 

97 

SUB A 

75 

LD (HL),L 

98 

SBC A , B 

76 

HALT 

99 

SBC A,C 

77 

LD (HL),A 

9 A 

SBC A,D 

78 

LD A, B 

9B 

SBC A,E 

79 

LD A,C 

9C 

SBC A, H 

7A 

LD A, D 

9D 

SBC A,L 

7B 

LD A,E 

9E 

SBC A,(HL) 

7C 

LD A,H 

9F 

SBC A,A 

7D 

LD A, L 

AO 

AND B 

7E 

LD A,(HL) 

A1 

AND C 

7F 

LD A,A 

A2 

AND D 

80 

ADD A,B 

A3 

AND E 

81 

ADD A,C 

A4 

AND H 

82 

ADD A,D 

A5 

AND L 

83 

ADD A,E 

A6 

AND (HL) 

84 

ADD A,H 

A7 

AND A 
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A8 

XOR B 

CB 0 0 

RLC B 

A9 

XOR C 

CB 01 

RLC C 

AA 

XOR D 

CB 02 

RLC D 

AB 

XOR E 

CB 03 

RLC E 

AC 

XOR H 

CB 04 

RLC H 

AD 

XOR L 

CB 05 

RLC L 

AE 

XOR (HL) 

CB 06 

RLC (HI 

AF 

XOR A 

CB 07 

RLC A 

BO 

OR B 

CB 08 

RRC B 

B1 

OR C 

CB 09 

RRC C 

B2 

OR D 

CB 0A 

RRC D 

B3 

OR E 

CB 0B 

RRC E 

B4 

OR H 

CB 0C 

RRC H 

B5 

OR L 

CB 0D 

RRC L 

B6 

OR (HL) 

CB 0E 

RRC (HI 

B7 

OR A 

CB OF 

RRC A 

B8 

CP B 

CB 10 

RL B 

B9 

CP C 

CB 1 1 

RL C 

BA 

CP D 

CB 1 2 

RL D 

BB 

CP E 

CB 1 3 

RL E 

BC 

CP H 

CB 1 4 

RL H 

BD 

CP L 

CB 1 5 

RL L 

BE 

CP (HL) 

CB 1 6 

RL (HL 

BF 

CP A 

CB 1 7 

RL A 

CO 

RET NZ 

CB 18 

RR B 

Cl 

POP BC 

CB 19 

RR C 

C2 bb aa 

JP NZ,aabb 

CB 1 A 

RR D 

C3 bb aa 

JP aabb 

CB IB 

RR E 

C4 bb aa 

CALL NZ,aabb 

CB 1C 

RR H 

C5 

POSH BC 

CB ID 

RR L 

C6 nn 

ADD A,nn 

CB IE 

RR (HL 

C7 

RST 00 

CB IF 

RR A 

C8 

RET Z 

CB 20 

SLA B 

C9 

RET 

CB 21 

SLA C 

CA bb aa 

JP Z,aabb 

CB 22 

SLA D 
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CB 23 

SLA E 

CB 46 

BIT 0 , (HL) 

CB 24 

SLA H 

CB 47 

BIT 0,A 

CB 2 5 

SLA L 

CB 48 

BIT 1,B 

CB 26 

SLA (HL) 

CB 49 

BIT 1,C 

CB 27 

SLA A 

CB 4A 

BIT 1,D 

CB 28 

SRA B 

CB 4B 

BIT 1,E 

CB 2 9 

SRA C 

CB 4C 

BIT 1,H 

CB 2A 

SRA D 

CB 4D 

BIT 1,L 

CB 2B 

SRA E 

CB 4E 

BIT 1,(HL) 

CB 2C 

SRA H 

CB 4F 

BIT 1,A 

CB 2D 

SRA L 

CB 50 

BIT 2,B 

CB 2E 

SRA (HL) 

CB 51 

BIT 2,C 

CB 2F 

SRA A 

CB 52 

BIT 2,D 

CB 30 

SLI B 

CB 53 

BIT 2,E 

CB 31 

SLI C 

CB 54 

BIT 2,H 

CB 32 

SLI D 

CB 55 

BIT 2,L 

CB 3 3 

SLI E 

CB 56 

BIT 2,(HL) 

CB 34 

SLI H 

CB 57 

BIT 2,A 

CB 35 

SLI L 

CB 58 

BIT 3,B 

CB 36 

SLI (HL) 

CB 59 

BIT 3,C 

CB 37 

SLI A 

CB 5A 

BIT 3,D 

CB 38 

SRL B 

CB 5B 

BIT 3,E 

CB 39 

SRL C 

CB 5C 

BIT 3,H 

CB 3A 

SRL D 

CB 5D 

BIT 3,L 

CB 3B 

SRL E 

CB 5E 

BIT 3, (HL) 

CB 3C 

SRL H 

CB 5F 

BIT 3,A 

CB 3D 

SRL L 

CB 60 

BIT 4,B 

CB 3E 

SRL (HL) 

CB 61 

BIT 4,C 

CB 3F 

SRL A 

CB 62 

BIT 4,D 

CB 40 

BIT 0,B 

CB 63 

BIT 4,E 

CB 41 

BIT 0,C 

CB 6 4 

BIT 4,H 

CB 42 

BIT 0,D 

CB 65 

BIT 4,L 

CB 4 3 

BIT 0,E 

CB 66 

BIT 4 , (HL) 

CB 44 

BIT 0,H 

CB 67 

BIT 4,A 

CB 45 

BIT 0,L 

CB 6 8 

BIT 5,B 




CB 69 

BIT 5, C 

CB 8C 

RES 1,H 

CB 6A 

BIT 5,D 

CB 8D 

RES 1,L 

CB 6B 

BIT 5, E 

CB 8E 

RES 1,(HL) 

CB 6C 

BIT 5 ,H 

CB 8F 

RES 1,A 

CB 6D 

BIT 5 ,L 

CB 90 

RES 2 , B 

CB 6E 

BIT 5,(HL) 

CB 91 

RES 2,C 

CB 6F 

BIT 5,A 

CB 92 

RES 2 , D 

CB 70 

BIT 6 ,B 

CB 93 

RES 2,E 

CB 71 

BIT 6 ,C 

CB 94 

RES 2,H 

CB 72 

BIT 6,D 

CB 95 

RES 2 ,L 

CB 73 

BIT 6 ,E 

CB 96 

RES 2,(HL) 

CB 74 

BIT 6,H 

CB 97 

RES 2,A 

CB 75 

BIT 6,L 

CB 98 

RES 3,B 

CB 76 

BIT 6,(HL) 

CB 99 

RES 3,C 

CB 77 

BIT 6,A 

CB 9A 

RES 3,D 

“CB 78 

BIT 7,B 

CB 9B 

RES 3,E 

CB 79 

BIT 7,C 

CB 9C 

RES 3,H 

CB 7A 

BIT 7,D 

CB 9D 

RES 3,L 

CB 7B 

BIT 7,E 

CB 9E 

RES 3, (HL) 

CB 7C 

BIT 7,H 

CB 9F 

RES 3,A 

CB 7D 

BIT 7,L 

CB AO 

RES 4,B 

CB 7E 

BIT 7,(HL) 

CB A1 

RES 4,C 

CB 7F 

BIT 7,A 

CB A2 

RES 4,D 

"~CB 80 

RES 0,B 

CB A3 

RES 4,E 

CB 81 

RES 0,C 

CB A4 

RES 4,H 

CB 82 

RES 0,D 

CB A5 

RES 4,L 

CB 83 

RES 0,E 

CB A6 

RES 4,(HL) 

CB 84 

RES 0,H 

CB A 7 

RES 4,A 

CB 85 

RES 0 r L 

CB A8 

RES 5,B 

CB 86 

RES 0 , (HL) 

CB A9 

RES 5,C 

CB 87 

RES 0,A 

CB AA 

RES 5 , D 

CB 88 

RES 1 ,B 

CB AB 

RES 5 , E 

CB 89 

RES 1,C 

CB AC 

RES 5 , H 

CB 8A 

RES 1 ,D 

CB AD 

RES 5,L 

CB 8B 

RES 1 ,E 

CB AE 

RES 5,(HL) 
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CB 

AF 

RES 

5 ,A 

CB 

D2 

SET 

2 , D 

CB 

BO 

RES 

6 ,B 

CB 

D3 

SET 

2 ,E 

CB 

B1 

RES 

6, C 

CB 

D4 

SET 

2,H 

CB 

B2 

RES 

6 , D 

CB 

D5 

SET 

2 ,L 

CB 

B3 

RES 

6 ,E 

CB 

D6 

SET 

2, (HL) 

CB 

B4 

RES 

6 ,H 

CB 

D7 

SET 

2 , A 

CB 

B5 

RES 

6 ,L 

CB 

D8 

SET 

3,B 

CB 

B6 

RES 

6,(HL) 

CB 

D9 

SET 

3 , C 

CB 

B7 

RES 

6 # A 

CB 

DA 

SET 

3,D 

CB 

B8 

RES 

7, B 

CB 

DB 

SET 

3 , E 

CB 

B9 

RES 

7,C 

CB 

DC 

SET 

3 ,H 

CB 

BA 

RES 

7 r D 

CB 

DD 

SET 

3,L 

CB 

BB 

RES 

7 , E 

CB 

DE 

SET 

3,(HL) 

CB 

BC 

RES 

7 i H 

CB 

DF 

SET 

3,A 

CB 

BD 

RES 

7,L 

CB 

EO 

SET 

4 # B 

CB 

BE 

RES 

7 , (HL) 

CB 

El 

SET 

4,C 

CB 

BF 

RES 

7,A 

CB 

E2 

SET 

4 , D 

CB 

CO 

SET 

0 ,B 

CB 

E3 

SET 

4,E 

CB 

'Cl 

SET 

0 ,C 

CB 

E4 

SET 

4,H 

CB 

C2 

SET 

0 ,D 

CB 

E5 

SET 

4 # L 

CB 

C3 

SET 

0 ,E 

CB 

E6 

SET 

4,(HL) 

CB 

C4 

SET 

0 ,H 

CB 

E7 

SET 

4,A 

CB 

C5 

SET 

0 ,L 

CB 

E8 

SET 

5,B 

CB 

C6 

SET 

0 , (HL) 

CB 

E9 

SET 

5,C 

CB 

C7 

SET 

0 , A 

CB 

EA 

SET 

5»D 

CB 

C8 

SET 

1 ,B 

CB 

EB 

SET 

5,E 

CB 

C9 

SET 

1 ,C 

CB 

EC 

SET 

5,H 

CB 

CA 

SET 

1 ,D 

CB 

ED 

SET 

5,L 

CB 

CB 

SET 

1 | E 

CB 

EE 

SET 

5 , (HL ) 

CB 

CC 

SET 

1 ,H 

CB 

EF 

SET 

5,A 

CB 

CD 

SET 

1 ,L 

CB 

FO 

SET 

6 , B 

CB 

CE 

SET 

1/(HL) 

CB 

FI 

SET 

6 ,C 

CB 

CF 

SET 

1 , A 

CB 

F2 

SET 

6 , D 

CB 

DO 

SET 

2,B 

CB 

F3 

SET 

6 , E 

CB 

Dl 

SET 

2, C 

CB 

F4 

SET 

6 ,H 
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CB 

F5 



SET 

6 ,L 

DD 

2B 



DEC IX 

CB 

F6 



SET 

6 , (HL) 

DD 

34 

nn 


INC (IX+nn) 

CB 

F7 



SET 

6 , A 

DD 

35 

nn 


DEC (IX+nn) 

CB 

F8 



SET 

7,B 

DD 

36 

nn 

nl 

LD (IX+nn),nl 

CB 

F9 



SET 

7 , C 

DD 

39 



ADD IX,SP 

CB 

FA 



SET 

7 , D 

DD 

46 

nn 


LD B,(IX+nn) 

CB 

FB 



SET 

7,E 

DD 

4E 

nn 


LD C,(IX+nn) 

CB 

FC 



SET 

7, H 

DD 

56 

nn 


LD D,(IX+nn) 

CB 

FD 



SET 

7,L 

DD 

5E 

nn 


LD E,(IX+nn) 

CB 

FE 



SET 

7 ,(HL) 

DD 

66 

nn 


LD H,(IX+nn) 

CB 

FF 



SET 

7,A 

DD 

6E 

nn 


LD L,(IX+nn) 

CC 

bb 

aa 


CALL Z ,aabb 

DD 

70 

nn 


LD (IX+nn),B 

CD 

bb 

aa 


CALL aabb 

DD 

71 

nn 


LD (IX+nn),C 

CE 

nn 



ADC 

A, nn 

DD 

72 

nn 


LD (IX+nn),D 

CF 




RST 

08 

DD 

73 

nn 


LD (IX+nn),E 

DO 




RET 

NC 

DD 

74 

nn 


LD (IX+nn),H 

Dl 




POP 

DE 

DD 

75 

nn 


LD (IX+nn),L 

D2 

bb 

aa 


JP NC,aabb 

DD 

77 

nn 


LD (IX+nn),A 

D3 

nn 



OUT 

(nn),A 

DD 

7E 

nn 


LD A, (IX+nn) 

D4 

bb 

aa 


CALL NC,aabb 

DD 

86 

nn 


ADD A,(IX+nn) 

D5 




PUSH DE 

DD 

8E 

n? 


ADC A,(IX+nn) 

D6 

nn 



SUB 

nn 

DD 

96 

nn 


SUB (IX+nn) 

D7 




RST 

1 0 

DD 

9E 

nn 


SBC A,(IX+nn) 

D8 




RET 

C 

DD 

A6 

nn 


AND (IX+nn) 

D9 




EXX 


DD 

AE 

nn 


XOR (IX+nn) 

DA 

bb 

aa 


JP 

C,aabb 

DD 

B6 

nn 


OR (IX+nn) 

DB 

nn 



IN 

A, (nn) 

DD 

BE 

nn 


CP (IX+nn) 

DC 

bb 

aa 


CALL C,nn 

DD 

CB 

nn 

06 

RLC (IX+nn) 

DD 

09 



ADD 

IX,BC 

DD 

CB 

nn 

0E 

RRC (IX+nn) 

DD 

19 



ADD 

IX ,DE 

DD 

CB 

nn 

16 

RL (IX+nn) 

DD 

21 

bb 

aa 

LD 

IX,aabb 

DD 

CB 

nn 

1 E 

RR (IX+nn) 

DD 

22 

bb 

aa 

LD 

(aabb),IX 

DD 

CB 

nn 

26 

SLA (IX+nn) 

DD 

23 



INC 

IX 

DD 

CB 

nn 

2E 

SRA (IX+nn) 

DD 

29 



ADD 

IX ,IX 

DD 

CB 

nn 

36 

SLI (IX+nn) 

DD 

2A 

bb 

aa 

LD 

IX,(aabb) 

DD 

CB 

nn 

3E 

SRL (IX+nn) 
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DD 

CB 

nn 

46 

BIT 

0 , (IX+nn) 

E4 

bb 

aa 


CALL PO.aabb 

DD 

CB 

nn 

4E 

BIT 

1 , (IX+nn) 

E5 




PUSH HL 

DD 

CB 

nn 

56 

BIT 

2, (IX+nn) 

E6 

nn 



AND nn 

DD 

CB 

nn 

5E 

BIT 

3 , (IX+nn) 

E7 




RST 20 

DD 

CB 

nn 

66 

BIT 

4, (IX+nn) 

E8 




RET PE 

DD 

CB 

nn 

6E 

BIT 

5 , (IX+nn) 

E9 




JP (HL) 

DD 

CB 

nn 

76 

BIT 

6 , (IX+nn) 

EA 

bb 

aa 


JP PE,aabb 

DD 

CB 

nn 

7E 

BIT 

7 , (IX+nn) 

EB 




EX DE,HL 

DD 

CB 

nn 

86 

RES 

0 , (IX+nn) 

EC 

bb 

aa 


CALL PE,aabb 

DD 

CB 

nn 

8E 

RES 

1 , (IX+nn) 

ED 

40 



IN B,(C) 

DD 

CB 

nn 

96 

RES 

2 , (IX+nn) 

ED 

41 



OUT (C),B 

DD 

CB 

nn 

9E 

RES 

3 , (IX+nn) 

ED 

42 



SBC HL,BC 

DD 

CB 

nn 

A6 

RES 

4 , (IX+nn) 

ED 

43 

bb 

aa 

LD (aabb),BC 

DD 

CB 

nn 

AE 

RES 

5 , (IX+nn) 

ED 

44 



NEG 

DD 

CB 

nn 

B6 

RES 

6 , (IX+nn) 

ED 

45 



RETN 

DD 

CB 

nn 

BE 

RES 

7 , (IX+nn) 

ED 

46 



IM 0 

DD 

CB 

nn 

C6 

SET 

0, (IX+nn) 

ED 

47 



LD I,A 

DD 

CB 

nn 

CE 

SET 

1 , (IX+nn) 

ED 

48 



IN C,(C) 

DD 

CB 

nn 

D6 

SET 

2 , (IX+nn) 

ED 

49 



OUT (C),C 

DD 

CB 

nn 

DE 

SET 

3,(IX+nn) 

ED 

4A 



ADC HL,BC 

DD 

CB 

nn 

E6 

SET 

4,(IX+nn) 

ED 

4B 

bb 

aa 

LD BC,(aabb) 

DD 

CB 

nn 

EE 

SET 

5 , (IX+nn) 

ED 

4D 



RET I 

DD 

CB 

nn 

F6 

SET 

6 , (IX+nn) 

ED 

4F 



LD R, A 

DD 

CB 

nn 

FE 

SET 

7, (IX+nn) 

ED 

50 



IN D,(C) 

DD 

El 



POP 

IX 

ED 

51 



OUT (C),D 

DD 

E3 



EX 

(SP),IX 

ED 

53 

bb 

aa 

LD (aabb),DE 

DD 

E5 



PUSH IX 

ED 

56 



IM 1 

DD 

E9 



JP 

(IX) 

ED 

57 



LD A,I 

DD 

F9 



LD 

SP,IX 

ED 

58 



IN E,(C) 

DE 

nn 



SBC 

A, nn 

ED 

59 



OUT (C),E 

DF 




RST 

1 8 

ED 

5A 



ADC HL,DE 

EO 




RET 

PO 

ED 

5B 

bb 

aa 

LD DE,(aabb) 

El 




POP 

HL 

ED 

5E 



IM 2 

E2 

bb 

aa 


JP : 

PO,aabb 

ED 

5F 



LD A,R 

E3 




EX 

(SP),HL 

ED 

60 



IN H,(C) 
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ED 

61 

OUT (C),H 

ED 

62 

SBC HL,HL 

ED 

67 

RRD 

ED 

68 

IN L,(C) 

ED 

69 

OUT (C),L 

ED 

6A 

ADC HL,HL 

ED 

6F 

RLD 

ED 

70 

IN F , { C ) 

ED 

72 

SBC HL,SP 

ED 

73 bb aa 

LD (aabb),SP 

ED 

78 

IN A, (C) 

ED 

79 

OUT (C),A 

ED 

7A 

ADC HL ,SP 

ED 

7B bb aa 

LD SP,(aabb) 

ED 

AO 

LDI 

ED 

Al 

CPI 

ED 

A2 

INI 

ED 

A3 

OUTI 

ED 

A8 

LDD 

ED 

A9 

CPD 

ED 

AA 

IND 

ED 

AB 

OUTD 

ED 

BO 

LDIR 

ED 

B1 

CPIR 

ED 

B2 

INIR 

ED 

B3 

OTIR 

ED 

B8 

LDDR 

ED 

B9 

CPDR 

ED 

BA 

INDR 

ED 

BB 

OTDR 

EE 

nn 

XOR nn 

EF 


RST 28 

FO 


RET P 

FI 


POP AF 

F2 

bb aa 

JP P,aabb 


F3 




DI 


F4 

bb 

aa 


CALL P ,aabb 

F5 




PUSH AF 

F6 

nn 



OR nn 

F7 




RST 

30 

F8 




RET 

M 

F9 




LD : 

SP , HL 

FA 

bb 

aa 


JP 1 

M,aabb 

FB 




El 


FC 

bb 

aa 


CALL M,aabb 

FD 

09 



ADD 

IY, BC 

FD 

1 9 



ADD 

IY, DE 

FD 

21 

bb 

aa 

LD 

IY,aabb 

FD 

22 

bb 

aa 

LD 

(aabb),IY 

FD 

23 



INC 

IY 

FD 

29 



ADD 

IY, IY 

FD 

2A 

bb 

aa 

LD 

IY,(aabb) 

FD 

2B 



DEC 

IY 

FD 

34 

nn 


INC 

(IY+nn) 

FD 

35 

nn 


DEC 

(IY+nn) 

FD 

36 

nn 

nl 

LD 

(IY+nn),nl 

FD 

39 



ADD 

IY, SP 

FD 

46 

nn 


LD 

B,(IY+nn) 

FD 

4E 

nn 


LD 

C,(IY+nn) 

FD 

56 

nn 


LD 

D, (IY+nn) 

FD 

5E 

nn 


LD 

E,(IY+nn) 

FD 

66 

nn 


LD 

H,(IY+nn) 

FD 

6E 

nn 


LD 

L, (IY+nn) 

FD 

70 

nn 


LD 

(IY+nn),B 

FD 

71 

nn 


LD 

(IY+nn),C 

FD 

72 

nn 


LD 

(IY+nn),D 

FD 

73 

nn 


LD 

(IY+nn),E 

FD 

74 

nn 


LD 

(IY+nn),H 

FD 

75 

nn 


LD 

(IY+nn),L 

FD 

77 

nn 


LD 

(IY+nn),A 
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FD 

7E 

nn 


LD A,(IY+nn) 

FD 

CB 

nn 

D6 

SET 

2,(IY+nn) 

FD 

86 

nn 


ADD A,(IY+nn) 

FD 

CB 

nn 

DE 

SET 

3,(IY+nn) 

FD 

8E 

nn 


ADC A,(IY+nn) 

FD 

CB 

nn 

E6 

SET 

4,(IY+nn) 

FD 

96 

nn 


SUB (IY+nn) 

FD 

CB 

nn 

EE 

SET 

5,(IY+nn) 

FD 

9E 

nn 


SBC A,(IY+nn) 

FD 

CB 

nn 

F6 

SET 

6,(IY+nn) 

FD 

A6 

nn 


AND (IY+nn) 

FD 

CB 

nn 

FE 

SET 

7,(IY+nn) 

FD 

AE 

nn 


XOR (IY+nn) 

FD 

El 



POP 

IY 

FD 

B6 

nn 


OR (IY+nn) 

FD 

E3 



EX 

(SP) ,IY 

FD 

BE 

nn 


CP (IY+nn) 

FD 

E5 



PUSH IY 

FD 

CB 

nn 

06 

RLC (IY+nn) 

FD 

E9 



JP 

(IY) 

FD 

CB 

nn 

0E 

RRC (IY+nn) 

FD 

F9 



LD 

SP,IY 

FD 

CB 

nn 

16 

RL (IY+nn) 

FE 

nn 



CP 

nn 

FD 

CB 

nn 

IE 

RR (IY+nn) 

FF 




RST 

38 

FD 

CB 

nn 

26 

SLA (IY+nn) 







FD 

CB 

nn 

2E 

SRA (IY+nn) 







FD 

CB 

nn 

36 

SLI (IY+nn) 







FD 

CB 

nn 

3E 

SRL (IY+nn) 







FD 

CB 

nn 

46 

BIT 0, (IY+nn) 







FD 

CB 

nn 

4E 

BIT 1 , (IY+nn) 







FD 

CB 

nn 

56 

BIT 2,(IY+nn) 







FD 

CB 

nn 

5E 

BIT 3,(IY+nn) 







FD 

CB 

nn 

66 

BIT 4 , (IY+nn) 







FD 

CB 

nn 

6E 

BIT 5,(IY+nn) 







FD 

CB 

nn 

76 

BIT 6, (IY+nn) 







FD 

CB 

nn 

7E 

BIT 7, (IY+nn) 







FD 

CB 

nn 

86 

RES 0,(IY+nn) 







FD 

CB 

nn 

8E 

RES 1 , (IY+nn) 







FD 

CB 

nn 

96 

RES 2, (IY+nn) 







FD 

CB 

nn 

9E 

RES 3, (IY+nn) 







FD 

CB 

nn 

A6 

RES 4, (IY+nn) 







FD 

CB 

nn 

AE 

RES 5,(IY+nn) 







FD 

CB 

nn 

B6 

RES 6,(IY+nn) 







FD 

CB 

nn 

BE 

RES 7, (IY+nn) 







FD 

CB 

nn 

C6 

SET 0,(IY+nn) 







FD 

CB 

nn 

CE 

SET 1 , (IY+nn) 
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Instruction set in Alphabetical order 


8E 

ADC A,(HL) 

DD 8E nn 

ADC A,(IX+nn) 

FD 8E nn 

ADC A,(IY+nn) 

8F 

ADC A,A 

88 

ADC A,B 

89 

ADC A, C 

8A 

ADC A,D 

8B 

ADC A,E 

8C 

ADC A,H 

8D 

ADC A, L 

CE nn 

ADC A,nn 

ED 4A 

ADC HL,BC 

ED 5A 

ADC HL,DE 

ED 6A 

ADC HL,HL 

ED 7A 

ADC HL,SP 

86 

ADD A,(HL) 

DD 86 nn 

ADD A,(IX+nn) 

FD 86 nn 

ADD A,(IY+nn) 

87 

ADD A,A 

80 

ADD A,B 

81 

ADD A,C 

82 

ADD A,D 

83 

ADD A,E 

84 

ADD A,H 

85 

ADD A,L 

C6 nn 

ADD A,nn 

09 

ADD HL ,BC 

19 

ADD HL,DE 

29 

ADD HL,HL 

39 

ADD HL,SP 

DD 0 9 

ADD IX,BC 

DD 1 9 

ADD IX,DE 

DD 29 

ADD IX,IX 


DD 39 



ADD IX,SP 

FD 09 



ADD IY,BC 

FD 19 



ADD IY,DE 

FD 2 9 



ADD IY,IY 

FD 39 



ADD IY,SP 

A6 



AND (HL) 

DD A6 nn 


AND (IX+nn) 

FD A6 nn 


AND (IY+nn) 

A7 



AND A 

AO 



AND B 

Al 



AND C 

A2 



AND D 

A3 



AND E 

A4 



AND H 

A5 



AND L 

E6 nn 



AND nn 

CB 46 



BIT 0,(HL) 

DD CB 

nn 

46 

BIT 0,(IX+nn) 

FD CB 

nn 

46 

BIT 0,(IY+nn) 

CB 47 



BIT 0,A 

CB 40 



BIT 0,B 

CB 41 



BIT 0,C 

CB 42 



BIT 0,D 

CB 43 



BIT 0,E 

CB 44 



BIT 0,H 

CB 45 



BIT 0 ,L 

CB 4E 



BIT 1,(HL) 

DD CB 

nn 

4E 

BIT 1,(IX+nn) 

FD CB 

nn 

4E 

BIT 1,(IY+nn) 

CB 4F 



BIT 1,A 

CB 48 



BIT 1,B 
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CB 4 9 


BIT 1 ,C 

CB 4A 


BIT 1,D 

CB 4B 


BIT 1 ,E 

CB 4C 


BIT 1,H 

CB 4D 


BIT 1,L 

CB 56 


BIT 2,(HL) 

DD CB nn 

56 

BIT 2,(IX+nn) 

FD CB nn 

56 

BIT 2,(IY+nn) 

CB 57 


BIT 2,A 

CB 50 


BIT 2,B 

CB 51 


BIT 2,C 

CB 52 


BIT 2,D 

CB 53 


BIT 2,E 

CB 54 


BIT 2,H 

CB 55 


BIT 2,L 

CB 5E 


BIT 3,(HL) 

DD CB nn 

5E 

BIT 3,(IX+nn) 

FD CB nn 

5E 

BIT 3 , (IY+nn) 

CB 5F 


BIT 3,A 

CB 58 


BIT 3,B 

CB 59 


BIT 3,C 

CB 5A 


BIT 3,D 

CB 5B 


BIT 3 ,E 

CB 5C 


BIT 3 ,H 

CB 5D 


BIT 3,L 

CB 66 


BIT 4,(HL) 

DD CB nn 

66 

BIT 4,(IX+nn) 

FD CB nn 

66 

BIT 4,(IY+nn) 

CB 67 


BIT 4,A 

CB 60 


BIT 4,B 


CB 

61 



BIT 4, C 

CB 

62 



BIT 4 , D 

CB 

63 



BIT 4 , E 

CB 

64 



BIT 4,H 

CB 

65 



BIT 4,L 

CB 

6E 



BIT 5,(HL) 

DD 

CB 

nn 

6E 

BIT 5,(IX+nn) 

FD 

CB 

nn 

6E 

BIT 5,(IY+nn) 

CB 

6F 



BIT 5,A 

CB 

68 



BIT 5,B 

CB 

69 



BIT 5,C 

CB 

6A 



BIT 5,D 

CB 

6B 



BIT 5,E 

CB 

6C 



BIT 5,H 

CB 

6D 



BIT 5 ,L 

CB 

76 



BIT 6,(HL) 

DD 

CB 

nn 

76 

BIT 6 , (IX+nn) 

FD 

CB 

nn 

76 

BIT 6,(IY+nn) 

CB 

77 



BIT 6,A 

CB 

70 



BIT 6,B 

CB 

71 



BIT 6,C 

CB 

72 



BIT 6,D 

CB 

73 



BIT 6,E 

CB 

74 



BIT 6 ,H 

CB 

75 



BIT 6,L 

CB 

7E 



BIT 7,(HL) 

DD 

CB 

nn 

7E 

BIT 7,(IX+nn) 

FD 

CB 

nn 

7E 

BIT 7,(IY+nn) 

CB 

7F 



BIT 7 , A 

CB 

i 78 



BIT 7,B 
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CB 

79 


BIT 7 ,C 

2F 

CPL 

CB 

7A 


BIT 7,D 



CB 

7B 


BIT 7,E 

27 

DAA 

CB 

7C 


BIT 7,H 



CB 

7D 


BIT 7,L 

35 

DEC (HL) 





DD 35 nn 

DEC (IX+nn) 

DC 

bb 

aa 

CALL C,aabb 

FD 35 nn 

DEC (IY+nn) 

FC 

bb 

aa 

CALL M,aabb 

3D 

DEC A 

D4 

bb 

aa 

CALL NC,aabb 

05 

DEC B 

CD 

bb 

aa 

CALL aabb 

OB 

DEC BC 

C4 

bb 

aa 

CALL NZ,aabb 

OD 

DEC C 

F4 

bb 

aa 

CALL P,aabb 

15 

DEC D 

EC 

bb 

aa 

CALL PE,aabb 

1 B 

DEC DE 

E4 

bb 

aa 

CALL PO,aabb 

1 D 

DEC E 

CC 

bb 

aa 

CALL Z,aabb 

25 

DEC H 





2B 

DEC HL 

3F 



CCF 

DD 2B 

DEC IX 





FD 2B 

DEC IY 

BE 



CP (HL) 

2D 

DEC L 

DD 

BE 

nn 

CP (IX+nn) 

3B 

DEC SP 

FD 

BE 

nn 

CP (IY+nn) 



BF 



CP A 

F3 

DI 

B8 



CP B 



B9 



CP C 

1 0 nn 

DJNZ nn 

BA 



CP D 



BB 



CP E 

FB 

El 

BC 



CP H 



BD 



CP L 

E3 

EX (SP),HL 

FE 

nn 


CP nn 

DD E3 

EX (SP),IX 





FD E3 

EX (SP),IY 

ED 

A9 


CPD 

08 

EX AF,AF 1 

ED 

B9 


CPDR 

EB 

EX DE,HL 

ED 

A1 


CPI 

D9 

EXX 

ED 

B1 


CPIR 

76 

HALT 


140 


ED 4 6 

IM 0 

ED 56 

IM 1 

ED 5E 

IM 2 

ED 78 

IN A,(C) 

DB nn 

IN A,(nn) 

ED 40 

IN B,(C) 

ED 48 

IN C , ( C ) 

ED 50 

IN D,(C) 

ED 58 

IN E,(C) 

ED 70 

IN F,(C) 

ED 60 

IN H , ( C ) 

ED 68 

IN L , ( C ) 

34 

INC (HL) 

DD 34 nn 

INC (IX+nn) 

FD 34 nn 

INC (IY+nn) 

3C 

INC A 

04 

INC B 

03 

INC BC 

OC 

INC C 

1 4 

INC D 

1 3 

INC DE 

1 C 

INC E 

24 

INC H 

23 

INC HL 

DD 23 

INC IX 

FD 23 

INC IY 

2C 

INC L 

33 

INC SP 

ED AA 

IND 

ED BA 

INDR 

ED A2 

INI 

ED B2 

INIR 


E9 



jp 

(HL) 

DD 

E9 


jp 

(IX) 

FD 

E9 


jp 

(IY) 

DA 

bb 

aa 

jp 

C,aabb 

FA 

bb 

aa 

jp 

M,aabb 

D2 

bb 

aa 

jp 

NC,aabb 

C3 

bb 

aa 

jp 

aabb 

C2 

bb 

aa 

jp 

NZ,aabb 

F2 

bb 

aa 

jp 

P,aabb 

EA 

bb 

aa 

jp 

PE,aabb 

E2 

bb 

aa 

jp 

PO,aabb 

CA 

bb 

aa 

jp 

Z,aabb 

38 

nn 


JR 

C, nn 

1 8 

nn 


JR 

nn 

30 

nn 


JR 

NC, nn 

20 

nn 


JR 

NZ, nn 

28 

nn 


JR 

Z ,nn 

02 



LD 

(BC),A 

1 2 



LD 

(DE),A 

77 



LD 

(HL),A 

70 



LD 

(HL),B 

71 



LD 

(HL),C 

72 



LD 

(HL),D 

73 



LD 

(HL),E 

74 



LD 

(HL),H 

75 



LD 

(HL),L 

36 

nn 


LD 

(HL),nn 

DD 

77 

nn 

LD 

(IX+nn) , A 

DD 

70 

nn 

LD 

(IX+nn),B 

DD 

71 

nn 

LD 

(IX+nn),C 

DD 

72 

nn 

LD 

(IX+nn),D 

DD 

73 

nn 

LD 

(IX+nn),E 
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DD 

74 

nn 


LD 

(IX+nn) 

r H 

ID 



LD 

A, 

L 

DD 

75 

nn 


LD 

(IX+nn) 

,L 

3E 

nn 


LD 

A, 

nn 

DD 

36 

nn 

nl 

LD 

(IX+nn) 

# nl 

ED 

5F 


LD 

A, 

R 

FD 

77 

nn 


LD 

(IY+nn) 

r A 

46 



LD 

B, 

(HL) 

FD 

70 

nn 


LD 

(IY+nn) 

/ B 

DD 

46 

nn 

LD 

B, 

(IX+nn) 

FD 

71 

nn 


LD 

(IY+nn) 

,c 

FD 

46 

nn 

LD 

B, 

(IY+nn) 

FD 

72 

nn 


LD 

(IY+nn) 

r D 

47 



LD 

B, 

A 

FD 

73 

nn 


LD 

(IY+nn) 

,E 

40 



LD 

B, 

B 

FD 

74 

nn 


LD 

(IY+nn) 

#H 

41 



LD 

B, 

C 

FD 

75 

nn 


LD 

(IY+nn) 

,L 

42 



LD 

B, 

D 

FD 

36 

nn 

nl 

LD 

(IY+nn) 

f nl 

43 



LD 

B, 

E 








44 



LD 

B, 

H 

32 

bb 

aa 


LD 

(aabb), 

A 

45 



LD 

B, 

L 

ED 

43 

bb 

aa 

LD 

(aabb), 

BC 

06 

nn 


LD 

B, 

nn 

ED 

53 

bb 

aa 

LD 

(aabb), 

DE 







22 

bb 

aa 


LD 

(aabb), 

HL 

ED 

4B 

bb aa 

LD 

BC,(aabb) 

DD 

22 

bb 

aa 

LD 

(aabb), 

IX 

01 

bb 

aa 

LD 

BC,aabb 

FD 

22 

bb 

aa 

LD 

(aabb), 

IY 







ED 

73 

bb 

aa 

LD 

(aabb), 

SP 

4E 



LD 

c, 

(HL) 








DD 

4E 

nn 

LD 

c, 

(IX+nn) 

OA 




LD 

A,(BC) 


FD 

4E 

nn 

LD 

C, 

(IY+nn) 

1 A 




LD 

A , ( DE ) 


4F 



LD 

C, 

A 

7E 




LD 

A,(HL) 


48 



LD 

C, 

B 

DD 

7E 

nn 


LD 

A,(IX+nn) 

49 



LD 

C, 

C 

FD 

7E 

nn 


LD 

A,(IY+nn) 

4A 



LD 

C, 

D 

3A 

bb 

aa 


LD 

A, (aabb 

) 

4B 



LD 

C, 

E 

7F 




LD 

A, A 


4C 



LD 

C, 

H 

78 




LD 

A,B 


4D 



LD 

C, 

L 

79 




LD 

> 

n 


OE 

nn 


LD 

C, 

nn 

7A 




LD 

A, D 








7B 




LD 

A, E 


56 



LD 

D, 

(HL) 

1C 




LD 

A, H 


DD 

56 

nn 

LD 

D, 

(IX+nn) 

ED 

57 



LD 

A,I 


FD 

56 

nn 

LD 

D, 

(IY+nn) 
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57 



LD 

D, A 

2A 

bb 

aa 


LD 

HL 

, (aabb) 

50 



LD 

D,B 

21 

bb 

aa 


LD 

HL 

, aabb 

51 



LD 

D,C 








52 



LD 

D, D 

ED 

47 



LD 

I, 

A 

53 



LD 

D, E 








LD 

D,L 




DD 

21 

bb 

aa 

LD 

IX 

,aabb 

1 6 

nn 


LD 

D, nn 













FD 

2A 

bb 

aa 

LD 

IY 

,(aabb) 

ED 

5B 

bb aa 

LD 

DE,(aabb) 

FD 

21 

bb 

aa 

LD 

IY 

,aabb 

1 1 

bb 

aa 

LD 

DE,aabb 













6E 




LD 

L, 

(HL) 

5E 



LD 

E, (HL) 

DD 

6E 

nn 


LD 

L, 

(IX+nn) 

DD 

5E 

nn 

LD 

E, (XX+nn) 

FD 

6E 

nn 


LD 

L, 

(IY+nn) 

FD 

5E 

nn 

LD 

E, (IY+nn) 

6F 




LD 

L, 

A 

5F 



LD 

E , A 

68 




LD 

L, 

B 

58 



LD 

E, B 

69 




LD 

L, 

C 

59 



LD 

E,C 

6A 




LD 

L, 

D 

5A 



LD 

E,D 

6B 




LD 

L, 

E 

5B 



LD 

E,E 

6C 




LD 

L, 

H 

5C 



LD 

E, H 

6D 




LD 

L, 

L 

5D 



LD 

E, L 

2E 

nn 



LD 

L, 

, nn 

IE 

nn 


LD 

E,nn 













ED 

4F 



LD 

R | 

, A 

66 



LD 

H, (HL) 








DD 

66 

nn 

LD 

H, (IX+nn) 

ED 

7B 

bb 

aa 

LD 

SP , (aabb] 

FD 

66 

nn 

LD 

H, (IY+nn) 

F9 




LD 

SP , HL 

67 



LD 

H, A 

DD 

F9 



LD 

SP,IX 

60 



LD 

H , B 

FD 

F9 



LD 

SP,IY 

61 



LD 

H , C 

31 

bb 

aa 


LD 

SP,aabb 

62 



LD 

H, D 








63 



LD 

H, E 

ED 

A8 



LDD 


64 



LD 

H,H 

ED 

B8 



LDDR 


65 



LD 

H , L 

ED 

> 

o 



LDI 


26 

nn 


LD 

H, nn 

ED 

BO 



LDIR 
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ED 

44 

NEG 

DD 

El 



POP 

IX 




FD 

El 



POP 

IY 

00 


NOP 










F5 




PUSH 

AF 

B6 


OR (HL) 

C5 




PUSH 

BC 

DD 

B6 nn 

OR (IX+nn) 

D5 




PUSH 

DE 

FD 

B6 nn 

OR (IY+nn) 

E5 




PUSH 

HL 

B7 


OR A 

DD 

E5 



PUSH 

IX 

BO 


OR B 

FD 

E5 



PUSH 

IY 

B1 


OR C 







B2 


OR D 

CB 

86 



RES 

0,(HL) 

B3 


OR E 

DD 

CB 

nn 

86 

RES 

0,(IX+nn) 

B4 


OR H 

FD 

CB 

nn 

86 

RES 

0,(IX+nn) 

B5 


OR L 

CB 

87 



RES 

0 , A 

F6 

nn 

OR nn 

CB 

80 



RES 

0 , B 




CB 

81 



RES 

0,C 

ED 

BB 

OTDR 

CB 

82 



RES 

0, D 

ED 

B3 

OTIR 

CB 

83 



RES 

0,E 




CB 

84 



RES 

0 ,H 

ED 

79 

OUT (C),A 

CB 

85 



RES 

0,L 

ED 

41 

OUT (C),B 







ED 

49 

OUT (C),C 

CB 

8E 



RES 

1 , (HL) 

ED 

51 

OUT (C),D 

DD 

CB 

nn 

8E 

RES 

1 , (IX+nn) 

ED 

59 

OUT (C),E 

FD 

CB 

nn 

8E 

RES 

1 , (IY+nn) 

ED 

61 

OUT (C),H 

CB 

8F 



RES 

1 , A 

ED 

69 

OUT (C),L 

CB 

88 



RES 

1 ,B 

D3 

nn 

OUT (nn),A 

CB 

89 



RES 

1 ,C 




CB 

8A 



RES 

1 ,D 

ED 

AB 

OUTD 

CB 

8B 



RES 

1 , E 

ED 

A3 

OUTI 

CB 

8C 



RES 

1 , H 




CB 

8D 



RES 

1 , L 

FI 


POP AF 







Cl 


POP BC 

CB 

96 



RES 

2 , (HL) 

D1 


POP DE 

DD 

CB 

nn 

96 

RES 

2, (IX+nn) 

El 


POP HL 

FD 

CB 

nn 

96 

RES 

2, (IY+nn) 
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CB 97 



RES 2,A 

CB 90 



RES 2 , B 

CB 91 



RES 2,C 

CB 92 



RES 2,D 

CB 93 



RES 2,E 

CB 94 



RES 2,H 

CB 95 



RES 2 ,L 

CB 9E 



RES 3,(HL) 

DD CB 

nn 

9E 

RES 3,(IX+nn) 

FD CB 

nn 

9E 

RES 3,(IY+nn) 

CB 9F 



RES 3,A 

CB 98 



RES 3,B 

CB 99 



RES 3,C 

CB 9A 



RES 3,D 

CB 9B 



RES 3,E 

CB 9C 



RES 3,H 

CB 9D 



RES 3,L 

CB A6 



RES 4,(HL) 

DD CB 

nn 

A6 

RES 4, (IX+nn) 

FD CB 

nn 

A6 

RES 4, (IY+nn) 

CB A 7 



RES 4,A 

CB AO 



RES 4,B 

CB A1 



RES 4,C 

CB A2 



RES 4,D 

CB A3 



RES 4,E 

CB A4 



RES 4,H 

CB A5 



RES 4 ,L 

CB AE 



RES 5,(HL) 

DD CB 

nn 

AE 

RES 5,(IX+nn) 

FD CB 

nn 

AE 

RES 5,(IY+nn) 

CB AF 



RES 5,A 

CB A8 



RES 5 , B 


CB A9 


RES 5, C 

CB AA 


RES 5,D 

CB AB 


RES 5 , E 

CB AC 


RES 5,H 

CB AD 


RES 5,L 

CB B6 


RES 6,(HL) 

DD CB nn 

B6 

RES 6,(IX+nn) 

FD CB nn 

B6 

RES 6,(IY+nn) 

CB B7 


RES 6,A 

CB BO 


RES 6,B 

CB B1 


RES 6 ,C 

CB B2 


RES 6,D 

CB B3 


RES 6,E 

CB B4 


RES 6,H 

CB B5 


RES 6,L 

CB BE 


RES 7,(HL) 

DD CB nn 

BE 

RES 7,(IX+nn) 

FD CB nn 

BE 

RES 7,(IY+nn) 

CB BF 


RES 7,A 

CB B8 


RES 7,B 

CB B9 


RES 7 , C 

CB BA 


RES 7 , D 

CB BB 


RES 7 , E 

CB BC 


RES 7 , H 

CB BD 


RES 7 , L 

C9 


RET 

D8 


RET C 

F8 


RET M 

DO 


RET NC 

CO 


RET NZ 

FO 


RET P 

E8 


RET PE 
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EO 




RET PO 

DD 

CB 

nn 

IE 

RR (IX+nn) 

C8 




RET Z 

FD 

CB 

nn 

IE 

RR (IY+nn) 






CB 

1 F 



RR A 

ED 

4D 



RETI 

CB 

1 8 



RR B 

ED 

45 



RETN 

CB 

1 9 



RR C 






CB 

1 A 



RR D 

CB 

1 6 



RL (HL) 

CB 

1 B 



RR E 

DD 

CB 

nn 

16 

RL (IX+nn) 

CB 

1 C 



RR H 

FD 

CB 

nn 

1 6 

RL (IY+nn) 

CB 

1 D 



RR L 

CB 

17 



RL A 






CB 

10 



RL B 

IF 




RRA 

CB 

1 1 



RL C 






CB 

12 



RL D 

CB 

0E 



RRC (HL) 

CB 

1 3 



RL E 

DD 

CB 

nn 

OE 

RRC (IX+nn) 

CB 

1 4 



RL H 

FD 

CB 

nn 

OE 

RRC (IY+nn) 

CB 

15 



RL L 

CB 

OF 



RRC A 






CB 

08 



RRC B 

1 7 




RLA 

CB 

09 



RRC C 






CB 

OA 



RRC D 

CB 

06 



RLC (HL) 

CB 

OB 



RRC E 

DD 

CB 

nn 

06 

RLC (IX+nn) 

CB 

OC 



RRC H 

FD 

CB 

nn 

06 

RLC (IY+nn) 

CB 

OD 



RRC L 

CB 

07 



RLC A 






CB 

00 



RLC B 

OF 




RRCA 

CB 

01 



RLC C 






CB 

02 



RLC D 

ED 

67 



RRD 

CB 

03 



RLC E 






CB 

04 



RLC H 

C7 




RST 0 

CB 

05 



RLC L 

CF 




RST 8h 






D7 




RST lOh 

07 




RLC A 

DF 




RST 18h 






E7 




RST 20h 

ED 

6F 



RLD 

EF 




RST 28h 






F7 




RST 30h 

CB 

IE 



RR (HL) 

FF 




RST 38h 
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9E 


SBC 

A, (HL) 

CB 

C9 


SET 

1 ,C 

DD 

9E nn 

SBC 

A, (IX+nn) 

CB 

CA 


SET 

1 , D 

FD 

9E nn 

SBC 

A, (IY+nn) 

CB 

CB 


SET 

1 , E 

9F 


SBC 

A, A 

CB 

CC 


SET 

1 ,H 

98 


SBC 

A, B 

CB 

CD 


SET 

1 ,L 

99 


SBC 

A, C 






9A 


SBC 

A, D 

CB 

D6 


SET 

2,(HL) 

9B 


SBC 

A, E 

DD 

CB nn 

D6 

SET 

2,(IX+nn) 

9C 


SBC 

A, H 

FD 

CB nn 

D6 

SET 

2,(IY+nn) 

9D 


SBC 

A, L 

CB 

D7 


SET 

2,A 

DE 

nn 

SBC 

A, nn 

CB 

DO 


SET 

2 ,B 





CB 

D1 


SET 

2 , C 

ED 

42 

SBC 

HL, BC 

CB 

D2 


SET 

2 , D 

ED 

52 

SBC 

HL , DE 

CB 

D3 


SET 

2 r E 

ED 

62 

SBC 

HL, HL 

CB 

D4 


SET 

2 , H 

ED 

72 

SBC 

HL , SP 

CB 

D5 


SET 

2 , L 


37 




SCF 


CB 

DE 



SET 

3,(HL) 







DD 

CB 

nn 

DE 

SET 

3,(IX+nn) 

CB 

C6 



SET 

0 , (HL) 

FD 

CB 

nn 

DE 

SET 

3,(IY+nn) 

DD 

CB 

nn 

C6 

SET 

0 , (IX+nn) 

CB 

DF 



SET 

3,A 

FD 

CB 

nn 

C6 

SET 

0, (IY+nn) 

CB 

D8 



SET 

3,B 

CB 

C7 



SET 

0, A 

CB 

D9 



SET 

3,C 

CB 

CO 



SET 

0 ,B 

CB 

DA 



SET 

3 f D 

CB 

Cl 



SET 

0,C 

CB 

DB 



SET 

3,E 

CB 

C2 



SET 

0 , D 

CB 

DC 



SET 

3,H 

CB 

C3 



SET 

0 , E 

CB 

DD 



SET 

3,L 

CB 

C4 



SET 

0 ,H 







CB 

C5 



SET 

0 ,L 

CB 

E6 



SET 

4,(HL) 







DD 

CB 

nn 

E6 

SET 

4,(IX+nn) 

CB 

CE 



SET 

1 , ( HL ) 

FD 

CB 

nn 

E6 

SET 

4,(IY+nn) 

DD 

CB 

nn 

CE 

SET 

1 , (IX+nn) 

CB 

E7 



SET 

4,A 

FD 

CB 

nn 

CE 

SET 

1 ,(IY+nn) 

CB 

EO 



SET 

4,B 

CB 

CF 



SET 

1 , A 

CB 

El 



SET 

4,C 

CB 

C8 



SET 

1 ,B 

CB 

E2 



SET 

4 , D 
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CB 

E3 



SET 

4 r E 

CB 

26 



SLA 

(HL) 

CB 

E4 



SET 

4,H 

DD 

CB 

nn 

26 

SLA 

(IX+nn) 

CB 

E5 



SET 

4 »L 

FD 

CB 

nn 

26 

SLA 

(IY+nn) 







CB 

27 



SLA 

A 

CB 

EE 



SET 

5,(HL) 

CB 

20 



SLA 

B 

DD 

CB 

nn 

EE 

SET 

5,(IX+nn) 

CB 

21 



SLA 

C 

FD 

CB 

nn 

EE 

SET 

5, (IY+nn) 

CB 

22 



SLA 

D 

CB 

EF 



SET 

5,A 

CB 

23 



SLA 

E 

CB 

E8 



SET 

5,B 

CB 

24 



SLA 

H 

CB 

E9 



SET 

5»C 

CB 

25 



SLA 

L 

CB 

EA 



SET 

5,D 







CB 

EB 



SET 

5,E 

CB 

36 



SLI 

(HL) 

CB 

EC 



SET 

5,H 

DD 

CB 

nn 

36 

SLI 

(IX+nn) 

CB 

ED 



SET 

5,L 

FD 

CB 

nn 

36 

SLI 

(IY+nn) 







CB 

37 



SLI 

A 

CB 

F6 



SET 

6,(HL) 

CB 

30 



SLI 

B 

DD 

CB 

nn 

F6 

SET 

6,(IX+nn) 

. CB 

31 



SLI 

C 

FD 

CB 

nn 

F6 

SET 

6,(IY+nn) 

CB 

32 



SLI 

D 

CB 

F7 



SET 

6,A 

CB 

33 



SLI 

E 

CB 

FO 



SET 

6 ,B 

CB 

34 



SLI 

H 

CB 

FI 



SET 

6 , C 

CB 

35 



SLI 

L 

CB 

F2 



SET 

6 ,D 







CB 

F3 



SET 

6 , E 

CB 

2E 



SRA 

(HL) 

CB 

F4 



SET 

6 , H 

DD 

CB 

nn 

2E 

SRA 

(IX+nn) 

CB 

F5 



SET 

6 ,L 

FD 

CB 

nn 

2E 

SRA 

(IY+nn) 







CB 

2F 



SRA 

A 

CB 

FE 



SET 

7 , ( HL) 

CB 

28 



SRA 

B 

DD 

CB 

nn 

FE 

SET 

7, (IX+nn) 

CB 

29 



SRA 

C 

FD 

CB 

nn 

FE 

SET 

7,(IY+nn) 

CB 

2A 



SRA 

D 

CB 

FF 



SET 

7,A 

CB 

2B 



SRA 

E 

CB 

F8 



SET 

7,B 

CB 

2C 



SRA 

H 

CB 

F9 



SET 

7 i C 

CB 

2D 



SRA 

L 

CB 

FA 



SET 

7 f D 







CB 

FB 



SET 

7,E 

CB 

3E 



SRL 

(HL) 

CB 

FC 



SET 

7,H 

DD 

CB 

nn 

3E 

SRL 

(IX+nn) 

CB 

FD 



SET 

7,L 

FD 

CB 

nn 

3E 

SRL 

(IY+nn) 
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CB 

3F 

SRL 

A 

CB 

38 

SRL 

B 

CB 

39 

SRL 

C 

CB 

3A 

SRL 

D 

CB 

3B 

SRL 

E 

CB 

3C 

SRL 

H 

CB 

3D 

SRL 

L 

96 


SUB 

(HL) 

DD 

96 nn 

SUB 

(IX+nn) 

FD 

96 nn 

SUB 

(IY+nn) 

97 


SUB 

A 

90 


SUB 

B 

91 


SUB 

C 

92 


SUB 

D 

93 


SUB 

E 


94 


SUB 

H 

95 


SUB 

L 

D6 

nn 

SUB 

nn 

AE 


XOR 

(HL) 

DD 

AE nn 

XOR 

(IX+nn) 

FD 

AE nn 

XOR 

(IY+nn) 

AF 


XOR 

A 

A8 


XOR 

B 

A9 


XOR 

C 

AA 


XOR 

D 

AB 


XOR 

E 

AC 


XOR 

H 

AD 


XOR 

L 

EE 

nn 

XOR 

nn 
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EX 

DEC 

DEC 

H 

D 

D 

H 

D 

D 

H 

D 

D 

H 

D 

D 


*256 



*256 



*256 



*256 



*256 


00 

00000 

0 

34 

13312 

52 

68 

26624 

104 

9C 

39936 

156 

DO 

53248 

208 

01 

00256 

1 

35 

13568 

53 

69 

26880 

105 

9D 

40192 

157 

D1 

53504 

209 

02 

00512 

2 

36 

13824 

54 

6A 

27136. 

106 

9E 

40448 

158 

D2 

53760 

210 

03 

00768 

3 

37 

14080 

55 

6B 

27392 

107 

9F 

40704 

159 

D3 

54016 

211 

04 

01024 

4 

38 

14336 

56 

6C 

27648 

108 

A0 

40960 

160 

D4 

54272 

212 

05 

01280 

5 

39 

14592 

57 

6D 

27904 

109 

A1 

41216 

161 

D5 

54528 

213 

06 

01536 

6 

3A 

14848 

58 

6E 

28160 

110 

A2 

41472 

162 

D6 

54784 

214 

07 

01792 

7 

3B 

15104 

59 

6F 

28416 

111 

A3 

41728 

163 

D7 

55040 

215 

08 

02048 

8 

3C 

15360 

60 

70 

28672 

112 

A4 

41984 

164 

D8 

55296 

216 

09 

02304 

9 

3D 

15616 

61 

71 

28928 

113 

A 5 

42240 

165 

D9 

55552 

217 

0A 

02560 

10 

3E 

15872 

62 

72 

29184 

114 

A6 

42496 

166 

DA 

55808 

218 

0B 

02816 

11 

3F 

16128 

63 

73 

29440 

115 

hi 

42752 

167 

DB 

56064 

219 

OC 

03072 

12 

40 

16384 

64 

74 

29696 

116 

A8 

43008 

168 

DC 

56320 

220 

0D 

03328 

13 

41 

16640 

65 

75 

29952 

117 

A 9 

43264 

169 

DD 

56576 

221 

0E 

03584 

14 

42 

16896 

66 

76 

30208 

118 

AA 

43520 

170 

DE 

56832 

222 

OF 

03840 

15 

43 

17152 

67 

77 

30464 

119 

AB 

43776 

171 

DF 

57088 

223 

10 

04096 

16 

44 

17408 

68 

78 

30720 

120 

AC 

44032 

172 

E0 

57344 

224 

11 

04352 

17 

45 

17664 

69 

79 

30976 

121 

AD 

44288 

173 

El 

57600 

225 

12 

04608 

18 

46 

17 920 

70 

7A 

31232 

122 

AE 

44 544 

174 

E2 

57856 

226 

13 

04864 

19 

47 

18176 

71 

7 B 

31488 

123 

AF 

44800 

175 

E3 

58112 

227 

14 

05120 

20 

48 

18432 

72 

1C 

31744 

124 

B0 

45056 

176 

E4 

58368 

228 

15 

05376 

21 

49 

18688 

73 

7D 

32000 

125 

B1 

4 5312 

177 

E 5 

58624 

229 

16 

05632 

22 

4 A 

18944 

74 

7 E 

32256 

126 

B2 

45568 

178 

E6 

58880 

230 

17 

05888 

23 

4B 

19200 

75 

7 F 

32512 

127 

B3 

45824 

179 

E7 

59136 

231 

18 

06144 

24 

4C 

19456 

76 

80 

32768 

128 

B4 

46080 

180 

E8 

59392 

232 

19 

06400 

25 

4 D 

19712 

77 

81 

33024 

129 

B 5 

46336 

181 

E9 

59648 

233 

1A 

06656 

26 

4E 

19968 

78 

82 

33280 

130 

B6 

46592 

182 

EA 

59904 

234 

IB 

06912 

27 

4 F 

20224 

79 

83 

33536 

131 

B7 

46848 

183 

EB 

60160 

235 

1C 

07168 

28 

50 

20480 

80 

84 

33792 

132 

B8 

47104 

184 

EC 

604 16 

236 

ID 

07424 

29 

51 

20736 

81 

85 

34 04 8 

133 

B9 

47360 

185 

ED 

60672 

237 

IE 

07680 

30 

52 

20992 

82 

86 

34304 

134 

BA 

47616 

186 

EE 

60928 

238 

IF 

07 936 

31 

53 

21248 

83 

87 

34560 

135 

BB 

47872 

187 

EF 

61184 

239 

20 

08192 

32 

54 

21504 

84 

88 

34816 

136 

BC 

48128 

188 

F0 

61440 

240 

21 

08448 

33 

55 

21760 

85 

89 

35072 

137 

BD 

48384 

189 

FI 

61696 

241 

22 

08704 

34 

56 

22016 

86 

8A 

35328 

138 

BE 

48640 

190 

F2 

61952 

242 

23 

08960 

35 

57 

22272 

87 

8B 

35584 

139 

BF 

48896 

191 

F3 

62208 

243 

24 

09216 

36 

58 

22528 

88 

8C 

35840 

140 

CO 

49152 

192 

F4 

62464 

244 

25 

09472 

37 

59 

22784 

89 

8D 

36096 

141 

Cl 

4 94 08 

193 

F5 

62720 

245 

26 

09728 

38 

5A 

23040 

90 

8E 

36352 

142 

C 2 

49664 

194 

F6 

62976 

246 

27 

09984 

39 

5B 

23296 

91 

8F 

36608 

143 

C3 

49920 

195 

F7 

63232 

247 

28 

10240 

40 

5C 

23552 

92 

90 

36864 

144 

C4 

50176 

196 

F8 

63488 

248 

29 

10496 

41 

5D 

23808 

93 

91 

37120 

145 

C 5 

50432 

197 

F9 

63744 

249 

2A 

10752 

42 

5E 

24064 

94 

92 

37376 

146 

C 6 

50688 

198 

FA 

64000 

250 

2B 

11008 

43 

5F 

24 320 

95 

93 

37632 

147 

Cl 

50944 

199 

FB 

64256 

251 

2C 

11264 

44 

60 

24576 

96 

94 

37888 

148 

C8 

51200 

200 

FC 

64 51 2 

252 

2D 

11520 

45 

61 

24832 

97 

95 

38144 

149 

C9 

51456 

201 

FD 

64768 

253 

2E 

11776 

46 

62 

25088 

98 

96 

38400 

150 

CA 

51712 

202 

FE 

65024 

254 

2F 

12032 

47 

63 

25344 

99 

97 

38656 

151 

CB 

51968 

203 

FF 

65280 

255 

30 

12288 

48 

64 

25600 

100 

98 

38912 

152 

CC 

52224 

204 




31 

12544 

49 

65 

25856 

101 

99 

39168 

153 

CD 

52480 

205 




32 

12800 

50 

66 

26112 

102 

9A 

39424 

154 

CE 

52736 

206 




33 

13056 

51 

67 

26368 

103 

9B 

39680 

155 

CF 

52992 

207 





The left column is the Hex code. 

The centre column is the decimal equivalent multiplied by 256 for 
calculating the M.S.B 

The third column is for use with the L.S.B. or single byte. 


1 





INDEX 


A & F reg manipulation 

51 

Non Z80 instructions 

63 

ADD A/ADC A 

42 

NOP 

62 

AND 

43 



A Register 

17 

OR 

43 

Assembly commands 

29 

OUT 

61 


OUTI/OTIR/OUTD/OTDR 

61 

B & C Registers 

17 



BIT 

49 

Parity overflow flag 

21 

Bit manipulation 

49 

Program counter 

15 

Block comparisons 

55 



Block transfer group 

39 

RAM pointers 

1 1 8 

Brackets convention 

30 

Re-routing programs 

56 

Byte search program 

121 

RES 

50 



Restore 

59 

Calls 

59 

Returns 

60 

Carry flag 

22 

RL 

47 

CCF 

53 

RLC 

46 

CP 

45 

RLD/RRD 

48 

CPI/CPD/CPIR/CPDR 

55 

ROM routines 

1 1 3 

CPL 

52 

rr/rrc 

47 

Crashes 

85 

Saving programs 

83 

D & E Registers 

1 8 

SBC 

43 

DAA 

51 

SCF 

54 

Data manip. commands 

41 

Screen messages 

72 

Data transfer commands 

31 

SET 

50 

Decimal arith. rotates 

48 

Sign flag 

20 

Direct screen addressing 

2 

SLA/SRA 

47 

DJNZ 

58 

Sprites 

96 



SRL 

48 

EX/EXX 

37 

Stack pointer 

1 6 



Storing Screens 

6 

Flag Register 

19 

SUB 

42 

Flag table 

23 

Subtract flag 

22 


System controls 

62 

H & L Registers 

18 



Half carry flag 

21 

Table construction 

86 

Halt 

62 



Hex to opcode table 

1 27 

User inputs 1 

75 

Hooks 

95 

User inputs 2 

78 



Using ZEN Assembler 

64 

I & R Registers 

26 

USR 

11 0 

IN 

61 



Index registers 

24 

XOR 

44 

INI/inir/ind/INDR 

61 



Input/Output commands 

61 

Z80 Instructions 

1 0 


Z80 Instruction table 

138 

Jumps 

56 

Zero flag 

20 

ldi/ldir/ldd/lddr 

39 

8 bit arithmetic group 

41 

Loader program 

104 

8 bit load group 

32 



8 bit registers 

1 7 

Machine code from Basic 

1 

8 bit shift/rotate 

46 

MSX Routines 

86 



Music program 

86 

16 bit arithmetic group 

45 


16 bit load group 

34 

NEG 

52 
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STARTING MACHINE CODE 
ON THE MSX 

Even with a good knowledge of machine code programming the 
user still requires additional information in how to access the 
inbuilt routines of a particular micro in order to achieve the 
simplest of tasks such as displaying messages on screen. 
Starting Machine Code on the MSX not only shows the ways the 
Z80 instructions are used but demonstrates these fundamental, 
but nevertheless crucial, routines in action in a way that even a 
first time user will find straightforward. 

From how to access machine code routine from Basic to using an 
Assembler, moving sprites and playing music in machine code on 
the MSX are all explained and demonstrated so lessening the 
imaginary and sometimes daunting divide between Basic and 
machine code programming. 
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